Invocation for non-CICS transaction abends

The following exits invoke Z Abend Investigator for real-time analysis when an abend other than a CICS® transaction abend occurs (for example, batch and IMS).

MVS IEAVTABX change options/suppress dump exit HFZXDCAP

  • This exit can be used with Language Environment®-based and non-Language Environment-based batch application programs.
  • Installation depends on the level of z/OS®:
    For z/OS 2.2 and later levels of z/OS
    HFZXDCAP is installed as an IEAVTABX_EXIT dynamic exit and is invoked for all abends, regardless of whether the job step has allocated a SYSMDUMP, SYSUDUMP, or SYSABEND DDname.

    The use of SLIP with ACTION=NODUMP (for example, a CANCEL command resulting in an Sx22 abend, for which most MVS™ systems have a matching SLIP TRAP) might not prevent Z Abend Investigator from being invoked through the IEAVTABX_EXIT. To prevent Z Abend Investigator invocation, ensure that the HFZCNFxx PARMLIB configuration member includes an Exclude option specification with a list of appropriate abend codes for your installation. A sample list of standard abend codes are included in the sample HFZCNF00 member provided in HFZ.SHFZSAM1.

    For levels of z/OS earlier than z/OS 2.2
    HFZXDCAP is installed in the MVS IEAVTABX CSECT exit list.

    The MVS IEAVTABX exit process is called by MVS only if the job step has allocated a SYSMDUMP, SYSUDUMP, or SYSABEND DDname, or if the HFZTABD USERMOD has been applied.

    A matching SLIP TRAP with ACTION=NODUMP prevents the MVS IEAVTABX exit from being called.
    Note: Using ACTION=NOSVCD or ACTION=(NOSYSA,NOSYSM,NOSYSU) might not prevent Z Abend Investigator from being invoked through the HFZXDCAP exit.

    To facilitate the Z Abend Investigator analysis, either disable the matching SLIP TRAP or, for LE-based applications, use the batch LE abnormal termination CEEEXTAN CSECT exit HFZXCEE instead.

  • Reanalysis of faults that were captured using this exit can be performed if a minidump was written.
  • LE-enabled abends need to run with TERMTHDACT, specifying the suboption UATRACE, UADUMP, UAONLY, or UAIMM, in the LE options so that LE calls a system dump to activate this exit. All other TERMTHDACT suboption settings skip the IEAVTABX exit invocation and invoke the CEEEXTAN exit (described below) instead.
  • This exit is APF authorized and therefore able to extract job related messages from the console.

For information about installing this exit, see Installing the MVS change options/suppress dump exit HFZXDCAP.

Batch LE abnormal termination CEEEXTAN CSECT exit HFZXCEE

  • This exit is effective only with Language Environment-based batch application programs.
  • There is no requirement for a JCL SYSMDUMP DD statement to be allocated for this exit to be invoked.
  • Reanalysis of faults that were captured using this exit can be performed if a minidump was written.
  • If the LE option TERMTHDACT is used with the UATRACE, UADUMP, UAONLY, or UAIMM suboption, then the MVS change options/suppress dump exit is invoked instead of the LE abnormal termination exit.
  • Permits instance-specific LE message inserts to be obtained, and thus included in the analysis report.

For information about installing this exit, see Enabling the Language Environment abnormal termination exit (HFZXCEE or HFZXCE64).

Both MVS HFZXDCAP and Batch LE HFZXCEE exits are installed

If both the batch Language Environment abnormal termination exit HFZXCEE and the MVS change options/suppress dump exit HFZXDCAP are installed, then the HFZXDCAP exit intercepts the abend instead of the LE exit if one of the following LE options is in effect:
  • TERMTHDACT(UATRACE)
  • TERMTHDACT(UADUMP)
  • TERMTHDACT(UAONLY)
  • TERMTHDACT(UAIMM)
and a SYSABEND, SYSUDUMP, or SYSMDUMP DDname is allocated (or the HFZTABD USERMOD has been applied).