gtpm6m0oMain Supervisor Reference

Altering and Displaying Data and Programs

TPF allows you to alter and display:

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.

Altering and Displaying Main Storage

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.

Displaying Link Map Data in C Load Modules

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.

Altering and Displaying File Records

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.

Altering and Displaying Programs, by Program Name

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.

Altering and Displaying Entries in the Program Allocation Table

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.

Displaying Program Linkage Types

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.

Maintaining a Memory Patch Deck

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.

Altering and Displaying System Generation Values

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.

Altering and Displaying Resource Control Values

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.