The dynamic dump

GDDM V3R2 Diagnosis

The dynamic dump

GDDM V3R2 Diagnosis
SC33-0870-01

You should take a dynamic dump if you think that the task is in a loop, or in the WAIT state, or if the IBM Support Center staff ask you for a dump to enable them to relate addresses in a GTF trace to modules in the TSO user's address space.

You can initiate a dynamic dump with the DUMP operator command. The dump is written to any free SYS1.DUMPnn data set, where nn is a numeric variable.

You can check that there is a free SYS1.DUMPnn data set by entering a DISPLAY DUMP STATUS command from the console.

The format of the command is:

D D,ST

or

D D,T

where the parameters are defined as follows:

STATUS (ST or S)

The system is to display a summary of the full or available status of each defined SYS1.DUMPnn data set. This information is displayed in two sections, one for DASD data sets and the other for tape data sets.

TITLE (T)

The system is to display the dump title and time of dump for each full direct access dump data set that you specify on the DSN parameter. This information is not displayed for tape dump data sets.

If all the SYS1.DUMPnn data sets are full, you must use the DUMPDS command to clear one or more of them. The format of the command is:


     DD CLEAR,DSN=nn

where nn is the number of the SYS1.DUMP data set.

You can now initiate the dynamic dump by entering the DUMP command. The format of the command is:


     DUMP COMM=('This is the title for the dump')

The title you give the dump can be 1 to 100 characters long. This title becomes the first record in the dump data set.

In response to the DUMP command, the system prompts you for the dump options with the following message:


     nn IEE094D SPECIFY OPERAND(S) FOR DUMP COMMAND

where nn is the message reply number.

You must respond to the IEE094D message with REPLY commands specifying dump options.

First specify the address space to dump using the ASID number, the jobname, or the TSO userid. The formats of the corresponding REPLY commands are:
```
         nn,ASID=3E,CONT

                 or

         nn,JOBNAME=JES2,CONT

                 or

         nn,TSONAME=USERID,CONT
```
Note: In the above examples, the parameter nn is the reply number of the IEE094D message.
The CONT parameter at the end of the command indicates to the dump command that you are going to specify additional parameters for the dump. This results in a further IEE094D message.
You must reply to this IEE094D message with a parameter SDATA specifying which areas of the system should be contained in the dump. The minimum SDATA specification is as follows:
```
         mm,SDATA=(CSA,GRSQ,RGN,PSA,SQA,TRT),END
```
where mm is the reply number of the IEE094D message to which you are responding.
Note: The END parameter indicates to the dump command that no further dump parameters are to be specified.
The SDATA options shown represent the following system areas:
CSA
Common Service Area
GRSQ
Global Resource Serialization (ENQ/DEQ/RESERVE) Queues
PSA
Prefixed Storage Area for all processors
RGN
Private Area of address space being dumped,including LSQA and SWA
SQA
System Queue Area
SUM
Summary Dump
TRT
GTF, system trace, master trace, and NIP hardcopy buffer data.

Note: Always check the console for an IEA911E message. If this message is displayed, only a partial dump has been written to the allocated data set, which might be unusable for later debugging. If IEA911E is displayed, you must increase the size of the dump data set, and recreate the error.

Notices | Terms of use | Support | Contact z/OS