gtpm6m0o | Main Supervisor Reference |
TPF allows you to alter and display:
- Main storage (by address or label)
- Data or program records (by file address)
- Fixed file records (by record type and ordinal number)
- Pool file records (by pool record type and ordinal number)
- File-resident programs (by program name) except for ISO-C programs
- Main storage-resident programs (by program name) except for ISO-C programs
- Link map data in C load modules (display only)
- Entries in the program allocation table (by program)
- System generation values
- Resource control values
- System allocation values in keypoint record A (CTKA).
You can use various commands to alter or display programs or data.
When altering data, you can include validation data in the message itself to
ensure that you are altering the appropriate data. (If the validation
data does not match, no alteration occurs.) Data is displayed as both
hexadecimal codes and printed characters, and altered data is shown both
before and after alteration. The amount of data that can be altered or
displayed varies by command and generally starts on a fullword
boundary. Following are summaries of the commands for altering and
displaying data and programs. For more information see TPF Operations.
You can use 2 sets of messages to alter and display main (core)
storage. For ZACOR and ZDCOR, you specify a main storage
address. For ZADCA and ZDDCA you specify a dump label. In a
tightly coupled system you can specify an I-stream.
- ZACOR
- Alter main storage by specifying a system virtual address and display
storage before and after alteration.
- ZDCOR
- Display storage by specifying a system virtual address. The display
starts on a fullword boundary unless you specify disassembled data which
starts at the specified address.
- ZADCA
- Alter main storage by specifying a dump label and display storage before
and after alteration.
- ZDDCA
- Display the address of a specified dump label or main storage by
specifying a dump label.
You can display the link map contained in a C load module by using the
ZDMAP command. The link map consists of a list of object files included
in the C load module, a list of C function names in the object files, and the
addresses of the object files and C functions.
Link map displays include both main storage addresses and the offsets of C
functions into their respective object files. Any time an object file
name or function name is displayed, its address is also displayed.
See TPF Operations for more information about the
ZDMAP command.
You can alter and display any file records using ZAFIL and ZDFIL or fixed
file records using ZAREC and ZDREC.
- ZAFIL
- Alter a file record by specifying the file address.
- ZDFIL
- Display or print a file record with a specified file address. You
can also display a chain of as many as 33 addresses from the specified record
or print a chain of as many as 33 records.
- ZAREC
- Alter a fixed-file record or pool record.
- ZDREC
- Display a specified number of bytes from a fixed-file record with a
specified record type beginning at a relative starting address or display the
file address of the record.
Other commands for altering or displaying files include:
- ZIFIL
- Initialize a fixed file data record by specifying a FACE equate value, a
record ID, record code check byte, and starting and ending ordinal numbers for
the initialization.
- ZDADD
- Display the file address for a specified record type and ordinal
number.
You can alter and display programs (except for ISO-C programs) using ZAPGM
and ZDPGM.
- ZAPGM
- Alter the file or main storage copy of a file-resident program.
- ZDPGM
- Display the file or main storage copy of a file-resident program.
You can alter and display entries in the program allocation table (PAT)
using ZAPAT and ZDPAT.
- ZAPAT
- Change a program entry in the file or main storage copy of the program
allocation table. Changes to the file copy take effect when you
re-IPL. If you specify a transfer vector entry, the parent program is
changed.
For ISO-C programs ZAPAT can authorize programs to use reentrant static
blocks. ZAPAT cannot change the module type. ZAPAT is restricted
to CLASS=SHARED for ISO-C programs, dynamic load modules (DLMs) and
libraries.
- ZDPAT
- ZDPAT displays a program entry in the program allocation table that
includes the program linkage type, class, file address, addressing mode,
authorization, and program size, and the base address of its PAT entry in main
memory (see the DSECT Program Allocation Table [IDSPAT] for more
information). If you specify a transfer vector entry, the entry for the
parent program is displayed.
You can display program names from the program allocation table (PAT) with
their program linkage type by using the ZDPLT command.
- ZDPLT
- Display program names from the program allocation table by specifying the
program linkage type and, optionally, the program name.
You can maintain and execute patch decks, which are groups of commands for
changing main storage (ZACOR, ZADCA, and ZAPGM).
- ZPTCH
- Maintain and execute patch decks. You can use ZPTCH to build as
many as 20 patch decks, each containing as many as 50 messages.
- ZSYSG
- Change and display system generation bits initially defined by SIP.
You cannot use this message to change system generation bits that require the
reassembling of programs, allocator changes, or the rerunning of SIP if they
are changed. Changes take effect on the next IPL of the system.
- ZCTKA
- Change and display storage allocation values. If you are using the
multiple database facility (MDBF), you can issue ZCTKA from any subsystem
(although some subsystem shared values can only be changed from the
BSS). Changes take effect on the next IPL of the system.
- ZSYSL
- Change and display shutdown levels defined for various block types in the
LODIC priority class table.
- ZTMSL
- Add, remove, change, or display time-slice attributes in the time slice
name table.