Exit xiceres – IBM SC34-6814-04 User Manual

Page 170

Advertising
background image

EXEC CICS SHUTDOWN
EXEC CICS XCTL

Note: Take care when issuing recursive commands not to cause a loop. For

example, it is your responsibility to avoid entering a loop when an interval
control request is issued from the XICEREQ exit. Use of the recursion
counter UEPRECUR is recommended.

Exit XICERES

When invoked

By the interval control program, before processing of a non-terminal-related
EXEC CICS START request that has been dynamically routed to this
region, where the routing region supports the “resource unavailable”
condition (RESUNAVAIL).

Exit-specific parameters

Note: CICS ignores any changes made by the exit program to the values

of any of the exit parameters. Your exit program can set a return
code, but not change any parameters.

UEPCLPS

Address of the command-level parameter structure. See “The
UEPCLPS exit-specific parameter” on page 152.

UEPICTOK

Address of a 4-byte token to be passed to XICEREQC.

UEPRCODE

Address of a 6-byte hexadecimal copy of the EIB return code
‘EIBRCODE’. For details of EIB return codes, refer to EIB fields, in
the CICS Application Programming Reference manual.

UEPRESP

Address of a 4-byte binary copy of the EIB response code
‘EIBRESP’.

UEPRESP2

Address of a 4-byte binary copy of the EIB response code
‘EIBRESP2’.

UEPTSTOK

Address of a 4-byte token that is valid throughout the life of a task.
See “Using the task token UEPTSTOK” on page 161.

UEPRECUR

Address of a halfword recursion counter. Because the XICERES
exit can never be called recursively in the same transaction, the
value of this field is always 0.

UEPRSRCE

Address of an 8-character copy of the EIB resource value,
EIBRSRCE.

UEPDATE

Address of a fullword copy of the EIB date value, EIBDATE.

UEPTIME

Address of a fullword copy of the EIB time value, EIBTIME.

Return codes

148

Customization Guide

Advertising