IBM MVS dump options to check to assure that you are providing a complete dump.

Document ID : KB000030191
Last Modified Date : 14/02/2018
Show Technical Document Details

MVS defines the starting dump options for each dump type in SYS1.PARMLIB

   (IEADMP00) for SYSUDUMP      (IBM provides no default IEADMP00).

   (IEAABD00) for SYSABEND

   (IEADMR00) for SYSMDUMP

                  SDUMP has no parmlib member and starts with empty option

 ABDUMP parameters for a SYSUDUMP data set may be specified as follows:

   . The dump request parameter list pointed to by the DUMPOPT keyword on an ABEND macro.

   . The initial system dump option specified in IEADMP00. This option is added to the options on the dump request parameter list.

   . The system dump options as altered by the CHNGDUMP(CD) command.

 As an example, IEADMP00 might be coded as follows:

 SDATA=(CB,DM,ENQ,ERR,IO,LSQA,PCDATA,SUM,SWA,TRT),PDATA=ALLPDATA

     where CB - Control blocks related to failing task

        DM - Data management control blocks (DEB, DCB, IOB) for the task

        ENQ - Global resource serialization control blocks for the task

        ERR - Recovery termination control blocks for the task

                (RTM2WA, regs from SDWA, SCB, EED)

        IO - IOS control blocks (UCB, EXCPD) for the task

        LSQA - Local system queue area for the address space. If storage is allocated for subpools 229, 230, and 249, they will be dumped for the current task.

        PCDATA - Program call information for the task being dumped

        SUM - Requests that the dump contain:

               . Title

               . Abend code and PSW at time of error

               . If PSW points to an active load module:

                 . name and address of the load module

                 . offset into the load module indicating where the error occurred.

                 . contents of the load module

               . Control blocks related to failing task

               . Recovery termination control blocks

               . Save Areas

               . Registers at the time of the error

               . Storage summary consisting of 1K bytes of storage before and 1K bytes of storage after the address pointed to by the regs and PSW.
                The storage will be printed only if the user is authorized to obtain it, and, when printed, duplicate addresses will be removed.

               . System trace table entries for the dumped address space

         SWA - Scheduler work area used for the failing task

         TRT - System trace table and GTF trace, as available.

 

         ALLDATA - All the following options are automatically specified

                   . PSW - Program status word at entry to ABEND

                   . REGS - Contents of general regs. at entry to ABEND

                   . SA - Requests save area linkage info and backward trace of save areas,  or

                     SAH - Requests only save area linkage information

                   . JPA - Contents of the job pack area that relate to the failing task; includes module name and contents

                   . LPA - Contents of the LPA related to the failing task; includes module name & contents. Also includes active SVCs related to failing task.

                   . ALLPA - Contents of both the job pack area and LPA, as they relate to the failing task, plus SVCs related to the failing task.

                   . SPLS - User storage subpools (0-127, 251, & 252)  related to the failing task.

                   . SUBTASKS - Problem data(PDATA) options requested for  the designated task will also be in effect for its subtask.

*----------------------------------------------------------------------

Use a DISPLAY DUMP operator command to get the dump mode and options in effect for SVC dumps, SYSABEND,  SYSMDUMP and SYSUDUMP. It will look like:

    DISPLAY DUMP,OPTIONS                 (or  D D,O)

     IEE857I 13.06.09 DUMP OPTION 912

     SYSABEND- ADD PARMLIB OPTIONS SDATA=(NUC,SQA,LSQA,SWA,TRT,CB,ENQ,DM,

                         IO,ERR,PCDATA,SUM,ALLVNUC), PDATA=(SA,REGS,LPA,

                         JPA,PSW,SPLS,SUBTASKS)

     SYSUDUMP- ADD PARMLIB OPTIONS SDATA=(LSQA,SWA,TRT,CB,ENQ,DM,IO,ERR,

                         PCDATA,SUM),PDATA=(SA,REGS,LPA,JPA,PSW,SPLS,

                         SUBTASKS)

     SYSMDUMP- ADD PARMLIB OPTIONS (NUC,SQA,LSQA,SWA,TRT,RGN,LPA,CSA,SUM,

                         ALLNUC,GRSQ,PSA,WLM)

     SDUMP- ADD OPTIONS (ALLPSA,PSA,NUC,SQA,LSQA,RGN,LPA,TRT,CSA,SWA,

                         SUMDUMP,ALLNUC,Q=YES,GRSQ),TYPE=(XMEME),

                         BUFFERS=00000060K,MAXSPACE=00000500M,

                         MSGTIME=99999MINUTES

NOTE: This information can also be obtained from CA-SYSVIEW/E using command DUMPOPTS.

 SYSUDUMP ADD  CURR SDATA LSQA,SWA,TRT,CB,ENQ,DM,IO,ERR,PCDATA,SUM

 .        .    .    PDATA SA,REGS,LPA,JPA,PSW,SPLS,SUBTASKS

 .        .    INIT SDATA LSQA,SWA,TRT,CB,ENQ,DM,IO,ERR,PCDATA,SUM

 .        .    .    PDATA SA,REGS,LPA,JPA,PSW,SPLS,SUBTASKS

 SYSABEND ADD  CURR SDATA NUC,SQA,LSQA,SWA,TRT,CB,ENQ,DM,IO,ERR,PCDATA,SUM

 .        .    .    PDATA SA,REGS,LPA,JPA,PSW,SPLS,SUBTASKS

 .        .    INIT SDATA NUC,SQA,LSQA,SWA,TRT,CB,ENQ,DM,IO,ERR,PCDATA,SUM,ALL

 .        .    .    PDATA SA,REGS,LPA,JPA,PSW,SPLS,SUBTASKS

 SYSMDUMP ADD  CURR SDATA NUC,SQA,LSQA,SWA,TRT,RGN,LPA,CSA,SUM,ALLNUC,GRSQ

 .        .    INIT SDATA NUC,SQA,LSQA,SWA,TRT,RGN,LPA,CSA,SUM,ALLNUC,GRSQ

 SDUMP    ADD  CURR SDATA ALLPSA,PSA,NUC,SQA,LSQA,RGN,LPA,TRT,CSA,SWA,SUM,ALLN

 SYSVIEW  ADD  CURR SDATA ALLPSA,SQA,LSQA,RGN,LPA,TRT,CSA,SWA,SUM,ALLNUC

*----------------------------------------------------------------------

Use a DISPLAY DUMP operator command to get the status of all defined SYS1.DUMPxx data sets on direct access. It looks like:

    DISPLAY DUMP,STATUS                  (or D D,S)

     IEE852I 13.11.13 SYS1.DUMP STATUS 423

     SYS1.DUMP DATA SETS AVAILABLE=006 AND FULL=000

     CAPTURED DUMPS=0000, SPACE USED=00000000M, SPACE FREE=00000500M

     AUTOMATIC ALLOCATION IS: INACTIVE

        NO SMS CLASSES DEFINED

        NO DASD VOLUMES DEFINED

        NAME=SYS1.DUMP.D&YYMMDD..T&HHMMSS..&SYSNAME..S&SEQ.

           EXAMPLE=SYS1.DUMP.D991013.T171113.XAE1.S00000

     SYS1.DUMP AVAILABLE DASD DATA SETS : 10-15

*----------------------------------------------------------------------

Use the CHNGDUMP command to change the mode and system dump options lis  for any dump type, or to request structures to be dumped when one or mo  systems connected to a coupling facility fail. The dump types are SDUMP SYSABEND, SYSUDUMP, and SYSMDUMP. If you issue multiple CHNGDUMP commands, the changes to the system are cumulative. There are three main functions provided:

   . CHNGDUMP DEL - Removes options from or Resets the system dump opts.

   . CHNGDUMP RESET - Resets the dump mode to ADD and the dump options  to their initial values

   . CHNGDUMP SET - Sets the dump modes and options

 An example:

   CHNGDUMP SET,SYSUDUMP,SDATA=SQA      (or CD SET,SYSUDUMP,SDATA=SQA)

     IEE712I CHNGDUMP PROCESSING COMPLETE

   D D,O

     IEE857I 13.29.06 DUMP OPTION 777

     SYSUDUMP- ADD OPTIONS SDATA=(SQA,LSQA,SWA,TRT,CB,ENQ,DM,IO,ERR,

                         PCDATA,SUM), PDATA=(SA,REGS,LPA,JPA,PSW,SPLS,

                         SUBTASKS)

   CD DEL,SYSUDUMP,SDATA=SQA

     IEE712I CHNGDUMP PROCESSING COMPLETE

   CD RESET,SYSUDUMP

     IEE712I CHNGDUMP PROCESSING COMPLETE

*----------------------------------------------------------------------

The DUMP command requests a system dump (SVC dump) of virtual storage.

The SVC dump is in a direct access data set. The data set may be either  pre-allocated dump data set named SYS1.DUMPxx, or an automatically allocated dump data set named according to an installation-specified  pattern. A system will only write one dump at a time.

 An example:

   DUMP COMM=(1-100 characters of title text)

    (response)   *xx IEE094D SPECIFY OPERAND(S) FOR DUMP COMMAND

    R xx,JOBNAME=jobname,SDATA=(ALLNUC,CSA,LPA,NUC,PSA,RGN,SQA,SUM,SWA,TRT),END

    (response)   *IEA911E COMPLETE DUMP ON SYS1.DUMP00

 Above, SDATA specifies the specific storage areas you want to dump.

  Valid options are:

     ALLNUC - all of the DAT-on nucleus, including page-protected areas,

              and all of the DAT-off nucleus

     COUPLE - XCF related information in the sysplex

     CSA - common service area

     GRSQ - global resource serialization (ENQ/DEQ/RESERVE) queues

     LPA - link pack area modules for the dumping task

     LSQA - local system queue area

     NUC - non-page-protected areas of the DAT-on nucleus

     PSA - prefixed storage areas for all processors

     NOPSA - no prefixed storage areas

     RGN - private area of address space being dumped

     SQA - system queue area

     NOSQA - no system queue area

     SUM - summary dump

     NOSUM - no summary dump

     SWA - scheduler work area

     TRT - GTF, system trace, master trace, and NIP hard-copy

     WLM - workload management related data areas and storage

     XESDATA - coupling facility related information

If you do not specify SDATA or you specify SDATA without any option  the system uses the following SDUMPX macro options:

        ALLPSA, SQ, SUM, and IO

You can also dump specific ranges of virtual storage as well using "begin,end" values in 4-byte hexadecimal numbers like:

   R xx,JOBNAME=mufjob,STOR=(010CD450,010FF400,0000012K,0000060K)

*----------------------------------------------------------------------

The SYSMDUMP can be specified in your JCL to catch any system abend from that region:

 //SYSMDUMP DD  DSN=XXXX.IPCS.DUMP,
 //             STORCLAS=IPCSDUMP,
 //             DISP=(NEW,CATLG,KEEP),
 //             SPACE=(CYL,(75,150),RLSE)

*----------------------------------------------------------------------

The above information was obtained from the following IBM manuals:

          z/OS   MVS System Commands

          z/OS   MVS Initialization and Tuning Reference

          z/OS   MVS Diagnosis: Tools and Service Aids