search cancel

IBM MVS or z/OS dump options for a complete dump

book

Article ID: 30191

calendar_today

Updated On:

Products

Datacom/DB Datacom/AD OPS/MVS Event Management & Automation Disk Backup and Restore - MVS DISK BACKUP AND RESTORE Datacom

Issue/Introduction

IBM dump options are provided to check the setup in order to provide a complete dump.

Environment

Any mainframe product or release

Resolution

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 options.

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

  • 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 SYSVIEW using command DUMPOPTS:

 Name     Mode Type Data  Options
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. 

    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 list for any dump type, or to request structures to be dumped when one or more 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)

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)

 

Additional Information

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