System termination program exit xsterm, Exit xsterm – IBM SC34-6814-04 User Manual

Page 228

Advertising
background image

2. The format of SRP_ERROR_DATA is shown in the CICS Data

Areas manual.

Return codes

UERCNOCA

Abnormally terminate the task with abend code ‘ASRB’. Do not
cancel any program-level abend exits that are associated with this
task.

UERCCANC

Abnormally terminate the task with abend code ‘ASRB’. Cancel any
program-level abend exits that are associated with this task.

UERCCICS

Abnormally terminate CICS.

XPI calls

Because CICS invokes the exit XSRAB in an error environment, you can
only use a subset of the XPI calls.

Only TRACE_PUT is available for general use.

You can use WAIT_MVS, but only after the exit program has determined
(from the SRP_CICS_CODE and SRP_USER_CODE fields) that the abend
has occurred in user application code, and not in CICS code.

Important

Note:

1. Take care when coding a program to run at the XSRAB exit point. If your

exit program causes the system recovery program to be reentered (if, for
example, a program check occurs) then CICS terminates abnormally,
with a DFHSR06xx message.

2. The default return code is ‘UERCNOCA’. This ensures that the task

abends if the exit is in error.

3. There is no ‘UERCNORM’ return code at this exit point, because the exit

is invoked after a failure.

4. The exit should not set the return code ‘UERCPURG’.

System termination program exit XSTERM

The XSTERM exit could be used to output final statistics to your statistics SMF data
sets, and to close them. (Note that CICS VSAM and BDAM data sets have already
been closed by CICS file control before the exit is invoked.)

Exit XSTERM

When invoked

During the second quiesce stage of a normal system shutdown,
immediately before the transient data and temporary storage buffers are
cleared. The exit is not invoked during an IMMEDIATE shutdown.

Exit-specific parameters

None.

Return codes

UERCNORM

Continue processing.

206

Customization Guide

Advertising