Maintaining Z Abend Investigator

Whenever maintenance has been applied to Z Abend Investigator by means of SMP/E APPLY, or removed from Z Abend Investigator by means of SMP/E RESTORE, perform the following steps:

Step 1: Remove libraries in LINKLIST from LLA and VLF control

If the following libraries are in LINKLIST, remove them from LLA and VLF control before performing the SMP/E APPLY:
  • Z Abend Investigator SMP/E target libraries
  • Target libraries of any USERMODs provided by Z Abend Investigator that update libraries in other products

Removing the libraries prevents errors that occur while loading the modules, when SMP/E has compressed or added extents to the libraries.

Step 2: IPL or update dynamically

IPL with CLPA. Alternatively, perform dynamic updates as follows:
  1. If the Z Abend Investigator module HFZDA has been placed in LPA using the SETPROG command, as opposed to placing HFZ.SHFZLPA1 in LPA, then do the following:
    1. Issue the command:
      SETPROG LPA,DELETE,MOD=(HFZDA),FORCE=YES

      (For complete information on the use of the SETPROG command, refer to MVS™ System Commands.)

    2. Issue the command:
      F LLA,REFRESH
    Optionally, to add the module HFZDA to LPA again to regain the region size space advantage, issue the command:
    SETPROG LPA,ADD,MOD=(HFZDA),DSN=LNKLST
  2. Otherwise, if HFZ.SHFZLPA1 is included in your LPALIST, issue this command:
    SETPROG LPA,ADD,MOD=(HFZDA),DSN=LNKLST
  3. If using CICS®, refresh all installed CICS exits. This refresh can be done by first uninstalling, and then reinstalling the exits, using the CFA transaction as described in Controlling CICS transaction abend analysis. There is no need to restart your CICS region.
  4. Stop and restart the Z Abend Investigator HFZS subsystem as described in Using the Z Abend Investigator HFZS subsystem.
  5. Users of the Z Abend Investigator ISPF interface should exit and re-enter ISPF for any updates to take effect.
  6. If you are using z/OS® V2.2 or later, refresh the IEAVTABX_EXIT by issuing the operator command:
    SET PROG=xx
    where xx matches the suffix of a PARMLIB PROGxx member that contains:
    EXIT REPLACE EXITNAME(IEAVTABX_EXIT) MODNAME(HFZXDCAP) STATE(ACTIVE)

Step 3: Verify the service level (optional)

Information about Z Abend Investigator installation status and applied maintenance is available through:
  • The Z Abend Investigator ISPF interface Services->Service Information pull-down menu.
  • The HFZCHKI utility, by submitting a job like this:
    //jobname JOB
    //EXEC PGM=HFZCHKI
    //SYSPRINT DD SYSOUT=*
The information provided by either method is similar, and includes:
IEAVTABX exit status
Tests the dynamic IEAVTABX exit, and reports an error on z/OS V2.2 if HFZXDCAP is statically defined to IEAVTABX. Displays no information for systems earlier than z/OS V2.2.
IEAVTSEL exit status
Reports if the Z Abend Investigator post-dump exit is defined.
Z Abend Investigator load modules
Presents the service information of important load modules.
Language Environment exit information
Checks whether various Z Abend Investigator LE exits are defined.
HFZOPTLM information
Reports the contents of HFZOPTLM, if defined.