Customizing the CICS environment
- XPCABND
- Global user exit using program HFZXCX53. This exit is the main exit provided to invoke Z Abend Investigator for CICS® transaction fault analysis.
- XDUREQ
- Global user exit using program HFZXCX53. This
exit can be used to invoke Z Abend Investigator for CICS® dumps generated from an EXEC CICS® DUMP command.
The analysis performed by Z Abend Investigator at this exit point is the same as for the XPCABND exit point.
- LE Exit
- LE abnormal termination exit using program HFZXCCEE. This exit is only effective with Language Environment®-based application programs
when the CEECXTAN exit has been set. CICS® AKCS abends can be analyzed using this exit, if both of the following are true:
- The failing program is LE enabled.
- An entry exists in the CICS® dump table for AKCS, specifying that a transaction dump is to be taken.
The first two of these exits are CICS® global user exit points, and Z Abend Investigator is enabled and disabled at these points using CICS® calls. By default, these exit points are not enabled in a CICS® region. They are enabled either by adding an entry to the CICS® PLT (see Adding the required programs to the startup PLT), or by using the supplied CFA transaction once CICS® has initialized (see Controlling CICS transaction abend analysis).
The LE abnormal termination exit, however, requires a modification to LE (see Configuring Language Environment for CICS to invoke Z Abend Investigator), and hence its effect is system wide. Z Abend Investigator provides a mechanism for controlling the use of this exit at a CICS® region level, but for this mechanism to work, the LE exit must first be enabled system wide. Once enabled at a system wide level, then the initial setting in a CICS® region is enabled.
HFZ.SHFZAUTH needs to be added to the DFHRPL concatenation of the CICS® JCL for any of the above exits to be successfully enabled.
To use Z Abend Investigator with CICS®, you need to perform the following steps:
- Configure Language
Environment® for CICS® to
invoke Z Abend Investigator
For details, see Configuring Language Environment for CICS to invoke Z Abend Investigator.
- Define the required programs to your CICS® system
For details, see Defining required programs to CICS.
- Add the required programs to your startup PLT
For details, see Adding the required programs to the startup PLT.
- Add the required programs to your shutdown PLT
For details, see Adding the required programs to the shutdown PLT.
- Define a transaction for Z Abend Investigator
For details, see Enabling dynamic control of analysis of CICS transaction abends.