Customizing SYSMDUMP dump contents

Table 1 contains a summary of how to customize the contents of SYSMDUMP dumps.

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

What changes: IEADMR00 contains the IBM-supplied default dump options. Replacing IEADMR00 changes the dump options for SYSMDUMP.

To add the link pack area to all SYSMDUMP dumps, while retaining all the IBM-supplied defaults, use IEBUPDTE to change the IEADMR00 member to contain:
SDATA=(NUC,SQA,LSQA,SWA,TRT,RGN,
SUM,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.

To add the link pack area to this SYSMDUMP dump, code in the program:
         ABEND 76,DUMP,
               DUMPOPT=PARMS
PARMS    SNAP  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 the link pack area to this SYSMDUMP dump, code in the recovery routine:
         SETRP ,DUMP=YES,
               DUMPOPT=PARMS
PARMS    SNAP  PDATA=LPA,MF=L
Entering CHNGDUMP operator command with SYSMDUMP parameter on a console with master authority. Change occurs: Immediately when entered
What changes:
  • For ADD: CHNGDUMP options are added to the IEADMR00 options, previous CHNGDUMP options, and macro parameter list options. The options remain added until a CHNGDUMP DEL,SYSMDUMP 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 IEADMR00 are used again.

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

To add the link pack area to all SYSMDUMP dumps until changed by CHNGDUMP DEL,SYSMDUMP, enter:
CHNGDUMP SET,ADD,SYSMDUMP=(LPA)
To return to the IEADMR00 options, enter:
CHNGDUMP DEL,SYSMDUMP
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.