Customizing SYSABEND dump contents

Table 1 summarizes how to customize the contents of SYSABEND dumps.

Table 1. Customizing SYSABEND dump contents
SYSABEND Customization Effect Example
Replacing IEAABD00 parmlib member (by using the IEBUPDTE utility). Change occurs: At system initialization

What changes: IEAABD00 contains the IBM-supplied default dump options. Replacing IEAABD00 changes the dump options for SYSABEND.

 To add program call data and the link pack area to all SYSABEND dumps, while retaining the IBM-supplied options, use IEBUPDTE to change the IEAABD00 member to contain: 
SDATA=(LSQA,CB,ENQ,TRT,ERR,
DM,IO,SUM,PCDATA)
PDATA=(PSW,REGS,SPLS,ALLPA,
SA,LPA)
Using a macro parameter list.

The DUMPOPT or DUMPOPX parameter on the ABEND or CALLRTM macro points to the parameter list. The list is usually created by a list-form SNAP or SNAPX macro.

Change occurs: At dump request

What changes: The macro parameter list options are added to the dump options list, but only for the dump being requested.

Note that SUBPLST in the macro parameter list overrides SPLS in the dump options list, but only for the dump being requested.

To add program call data and the link pack area to this SYSABEND dump, code in the program: 
         ABEND 76,DUMP,
               DUMPOPT=PARMS
PARMS    SNAP  SDATA=PCDATA,
               PDATA=LPA,MF=L
Recovery routines invoked by the recovery termination manager:
  • FRRs (function recovery routines) for a system component
  • ESTAE/ESTAI recovery routines established by an ESTAE or ESTAEX macro or the ESTAI parameter of an ATTACH or ATTACHX macro
  • ARRs (associated recovery routines)

These routines issue SETRP macros. To customize the dump contents, the DUMPOPT or DUMPOPX parameter on the SETRP macro points to a parameter list. The list is usually created by a list-form SNAP or SNAPX macro.

Change occurs: Just before dumping

What changes: The SETRP macro parameter list options are added to the dump options list, but only for the dump being requested.

 To add program call data and the link pack area to this SYSABEND dump, code in the recovery routine: 
         SETRP ,DUMP=YES,
               DUMPOPT=PARMS
PARMS    SNAP  SDATA=PCDATA,
               PDATA=LPA,MF=L
Entering CHNGDUMP operator command with SYSABEND parameter on a console with master authority. Change occurs: Immediately when entered
What changes:
  • For ADD: CHNGDUMP options are added to the IEAABD00 options, previous CHNGDUMP options, and all macro parameter list options. The options remain added until a CHNGDUMP DEL,SYSABEND operator command is entered.
  • For OVER: CHNGDUMP options override all other dump options.
  • For DEL: All CHNGDUMP options are deleted and the dump options in IEAABD00 are used again.

When more than one CHNGDUMP operator command with SYSABEND is entered, the effect is cumulative.

 To add program call data and the link pack area to all SYSABEND dumps until changed by CHNGDUMP DEL,SYSABEND, enter: 
CHNGDUMP SET,ADD,SYSABEND,
 SDATA=PCDATA,PDATA=LPA
To return to the IEAABD00 options, enter: 
CHNGDUMP DEL,SYSABEND
Through IEAVTABX installation exit name list. Change occurs: Just before dumping

What changes: The routine can add or delete options from the dump options, but only for the current dump.

 See z/OS MVS Installation Exits.
Through IEAVADFM or IEAVADUS installation exits. IEAVADFM is a list of installation routines to be run. IEAVADUS is one installation routine. Change occurs: During dumping. The routine runs during control block formatting of a dump with the CB option.

What changes: The routine can add control blocks to the dump.

 See z/OS MVS Installation Exits.
Parent topic: Customizing ABEND dump contents