Installing the Language Environment abnormal termination exits IDIXCEE and IDIXCE64
Two separate Language Environment (LE) invocation exits are required: one for 31-bit applications, and one for 64-bit applications.
31-bit applications (IDIXCEE):
Add the Fault Analyzer IDIXCEE invocation exit to the LE CEEEXTAN abnormal termination exit CSECT list as follows.
<<< REPLACE THESE 2 LINES WITH A COPY OF CEEEXTAN
AND OVERRIDE AS DESIRED >>>
with these
lines: CEEXAHD ,User exit header
CEEXART TERMXIT=IDIXCEE
CEEXAST ,Terminate the list
If more than one exit is specified in the CEEEXTAN list (for example, due to other similar third-party products also being used), then Fault Analyzer should be the first exit specified.
64-bit applications (IDIXCE64):
Add the Fault Analyzer IDIXCE64 invocation exit to the LE CELQXTAN abnormal termination exit CSECT list as follows.
<<< REPLACE THESE 2 LINES WITH A COPY OF CELQXTAN
AND OVERRIDE AS DESIRED >>>
with these lines: CEEXAHD AM=64 ,User exit header (AMODE 64)
CEEXART TERMXIT=IDIXCE64
CEEXAST ,Terminate the list
Activating the exits
These exits are activated by performing an IPL. If any of the updated load modules are in LPA, then the IPL must be performed with the CLPA option.
- LE in LPA Determine the data set name and load modules updated by the USERMODs from the APPLY job output and issue the command:
SETPROG LPA,ADD,MOD=(module-list),DSN=data-set-name
Note:If one or more of the updated load modules are not in LPA, then continue with the instructions for "LE not in LPA" below.Ensure ECSA size is sufficient to accommodate the additional storage required by the SETPROG LPA,ADD command.Note:Remember to reissue the SETPROG command after the next IPL, unless the IPL is performed with the CLPA option. - LE not in LPA If LE is not in LPA, it is assumed to be in LINKLIST. To activate the exits, issue the command:
If you prefer to selectively refresh only the affected load modules, then you need to check the SMP/E APPLY output for the updated data sets and load module names, add these to a CSVLLAxx parmlib member using the LIBRARIES and MEMBERS parameters, and then issue the commandF LLA,REFRESH
F LLA,UPDATE=xx
. Alternatively, use Data Set Commander for z/OS® to perform the refresh.
For general information about implementing LE abnormal termination exits, refer to the Language Environment® Customization book.
- The CICS® version of the AMODE 31 LE exit, CEECXTAN, which is installed with sample job CEEWCEXT, is very similar to the IDIXCEE exit. If you are going to install both, make sure that you double-check that you have used the correct names and not installed the same exit twice.
- There is currently no AMODE 64 version of this exit for CICS®.