PDUMP (Partial-Dump Request) Macro

This macro provides a hexadecimal dump of the general registers and of the virtual storage area that is contained between the two address expressions (address1 and address2).

The contents of registers 0 and 1 are overwritten, but the CPU status is retained. Thus, PDUMP furnishes a dynamic dump (snapshot) useful for program checkout. Processing continues with your next instruction.

Restrictions: The PDUMP macro cannot be used to process 31-bit addresses; these addresses must be specified in register notation. Also, the PDUMP macro cannot be used to dump data spaces; use the SDUMP or SDUMPX macro for this purpose.

The dump is always directed to SYSLST with 121-byte records (the first byte is an ASA control character). If SYSLST is not assigned, the PDUMP macro is ignored. If SYSLST is assigned to a CKD-type disk device, no output is produced.

If SYSLST is assigned to an IBM® 3211 and indexing was used before you issue the PDUMP macro, a certain number of characters on every line of the printed dump might be lost. To avoid this, reload the printer 's FCB (forms control buffer) by issuing an LFCB macro before you issue the DUMP macro. The FCB image that you load must not have an indexing byte.

If non-addressable areas are included in the range of PDUMP, the system issues a message to indicate this.

Format

Read syntax diagramSkip visual syntax diagramnamePDUMPaddress1( r1),address2( r2),MFG=area(S, area)( r3)

Requirements for the caller

AMODE:
24 or 31
RMODE:
24
ASC Mode:
Primary

Parameters

address1 | (r1),address2 | (r2)
One or both of the addresses can be specified in register notation. The specified addresses must be 3-byte addresses; 31-bit addresses are only allowed in register notation. If address2 is not greater than address1, or address1 is greater than the highest address in the allocated virtual storage, the macro results in no operation. If the value in address2 is greater than the end of the allocated virtual storage area, the virtual storage between address1 and the end of the allocated virtual storage is dumped.
MFG=area | (S,area) | (r3)
The operand is required if the program, which issues the PDUMP is to be reenterable. It specifies the address of a 64-byte dynamic storage area, that is, storage, which you obtained by a GETVIS macro; this area is needed by the system during execution of the macro.