Dumping virtual storage (SDUMPX, SDUMP, and IEATDUMP macros)
Where To Find Prerequisite Information
ABEND and SNAP dumps are available to both authorized and unauthorized programs. z/OS MVS Programming: Assembler Services Guide introduces ABEND and SNAP dumps and discusses functions that are available to all programs. The following topic discusses SVC dumps, which are available to authorized programs only and Transaction dumps which are available to both authorized and unauthorized programs. Before reading the following topic, read about ABEND and SNAP dumps in z/OS MVS Programming: Assembler Services Guide.
When an error occurs, a program can request a dump of virtual storage
that a programmer can use to diagnose the error. To request a dump
of the storage, the program can issue one of the following:
- The ABEND macro with the DUMP parameter, or the SETRP macro with DUMP=YES. These two macros produce an ABEND dump.
- The CALLRTM macro with DUMP=YES. This macro also produces an ABEND dump.
- Either the SDUMPX or SDUMP macro. These macros produce an unformatted SVC dump that is written to a SYS1.DUMPnn data set. IBM® recommends using SDUMPX over SDUMP, although MVS™ accepts SDUMP macro invocations.
- The IEATDUMP macro. This macro produces an unformatted Transaction dump that is written to a pre-allocated or automatically allocated data set.