XRF request-processing program exit XXRSTAT

XXRSTAT enables you to decide whether to terminate CICS® when either of the following occurs:

For more information about this exit and the circumstances in which you can use it, refer to the CICS/ESA 3.3 CICS XRF Guide.

Exit XXRSTAT

When invoked
After either of the following:
Exit-specific parameters
UEPERRA
Address of parameter list containing:
UEPGAPLD
Address of the 8-byte generic applid
UEPSAPLD
Address of the 8-byte specific applid
UEPDOMID
Address of the 4-byte domain ID
UEPERRID
Address of the 4-byte error ID.
Notes:
  1. No DSECT is provided for the above parameter list. You need to code your own DSECT to access the named fields.
  2. When VTAM has failed, the domain ID is ‘ZC  ’ (uppercase Z, uppercase C, and two blanks), and the error ID is the character string ‘3443’.
Return codes
UERCNORM
Take the system action. The system action depends on the reason why the exit was invoked:
  • For XRF, in the event of a VTAM failure: CICS continues processing as if the exit program had not been invoked.
  • For VTAM persistent sessions, in the event of a predatory takeover: CICS abends without a dump.
UERCCOIG
Ignore.
UERCABNO
Abend CICS without a dump.
UERCABDU
Abend CICS with a dump.
UERCPURG
Task purged during XPI call.
XPI calls
All can be used.

Related concepts
Overview -- what is a global user exit?
Overview of the XPI
Global user exit XPI examples, showing the use of storage
Related tasks
Writing global user exit programs
Making an XPI call
Related reference
List of global user exit points
The XPI functions
[[ Contents Previous Page | Next Page Index ]]