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:
- 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:
- 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.)
- 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
- Issue the command:
- Otherwise, if HFZ.SHFZLPA1 is included in your
LPALIST, issue this
command:
SETPROG LPA,ADD,MOD=(HFZDA),DSN=LNKLST
- 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.
- Stop and restart the Z Abend Investigator HFZS subsystem as described in Using the Z Abend Investigator HFZS subsystem.
- Users of the Z Abend Investigator ISPF interface should exit and re-enter ISPF for any updates to take effect.
- If you are using z/OS® V2.2 or later, refresh the
IEAVTABX_EXIT by issuing the operator
command:
where xx matches the suffix of a PARMLIB PROGxx member that contains:SET PROG=xx
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.
- CEEEXTAN and CEECXTAN exit information (Language Environment)
- Checks whether various Z Abend Investigator LE exits are defined.
- HFZOPTLM information
- Reports the contents of HFZOPTLM, if defined.