DUMP (Dump Request) Macro

This macro provides a hexadecimal dump of the following:
  • The contents of the entire supervisor area and the system GETVIS area, or of some supervisor control blocks only.
  • The contents of the partition that issued the macro.
  • The contents of the registers.
The dump includes the contents of just some of the supervisor control blocks (rather than the entire supervisor area) if either is true:
  • The STDOPT job control command specifies DUMP=PART or DUMP=NO.
  • A job control // OPTION statement with PARTDUMP or NODUMP is submitted.

The macro causes the job step to be terminated if DUMP was issued by the main (or only) task of the program. If DUMP was issued by a subtask, the macro causes that subtask to be detached without terminating the main task in the partition.

If the job control option SYSDUMP is active, the output of the dump is directed to the dump sublibrary of the partition. If NOSYSDMP is active, the output is directed to SYSLST. If SYSLST is assigned to tape, this tape must be positioned as wanted.

If SYSLST is assigned to an IBM® 3211 and indexing was used before you issue the DUMP macro, some 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 DUMP is issued by a job running in real mode, the storage contents of the partition are dumped only up to the limit as determined by the SIZE operand of the EXEC job control statement, plus the storage obtained dynamically through the GETVIS macro. If SIZE was not specified, the entire partition is dumped. If DUMP is issued by a program running in virtual mode, the entire partition is dumped.

Format

Read syntax diagramSkip visual syntax diagramnameDUMPRC=0n(15)

Requirements for the caller

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

Parameters

RC=0 | n | (15)
Indicates a user-specified return code, between 0 and 4095, which is passed to job control to reflect the result of the job step and to allow conditional execution of subsequent job steps.

If register notation is used, the return code must be contained in bytes 2 and 3 of the register.

If the operand is omitted, no return code is passed to job control.

The RC operand is only applicable for the main task; it is ignored if the DUMP macro is issued by a subtask.

Note: The DUMP macro modifies some of the user registers:
  • If the RC operand is not specified, the macro modifies register 1; all other registers are displayed unchanged.
  • If the RC operand is specified, the macro modifies registers 0, 1, 14, and 15; the other registers are displayed unchanged.