IBM SC34-6814-04 User Manual

Page 164

Advertising
background image

Note that this exit is invoked only if the request to be shipped is of type EXEC CICS
START NOCHECK. For EXEC CICS requests other than those with the NOCHECK
option (which is only available on START commands) the ‘SYSIDERR’ condition is
raised in the application program.

You can use the exit to specify whether or not the failed request is to be locally
queued, to be executed when the connection is reestablished.

Exit XISLCLQ:

When invoked

After a function shipping request of type EXEC CICS START NOCHECK
has failed because the remote system is not in service, a connection to the
remote system cannot be established, or no sessions are immediately
available, and your XISCONA exit program has specified that the request is
not to be queued in the issuing region.

Exit-specific parameters

UEPISPP

Address of a parameter list that contains:

UEPTCTSE

Address of the relevant terminal control table system entry.
The TCT system entry can be mapped using the DSECT
DFHTCTTE.

UEPXXTE

Address of the local transaction name, or 0 if SYSID was
specified in the command.

Note: Your program can use the transaction manager XPI

call INQUIRE_TRANDEF to obtain details of the
local transaction (see “The INQUIRE_TRANDEF call”
on page 406).

UEPPLIST

Address of the parameter list for the command.

Note: No DSECT is provided for the above parameter list. You have to

code your own DSECT to access the named fields.

Return codes

UERCSYS

Take the system action. This is determined by the value of the
LOCALQ attribute in the local TRANSACTION definition for the
remote transaction:

LOCALQ(YES)

The request is queued locally.

LOCALQ(NO)

‘SYSIDERR’ is returned to the application program.

UERCQUE

Queue the request locally (overriding the LOCALQ(NO) attribute, if
specified).

UERCIGN

Override the LOCALQ(YES) attribute, if specified, and return with
‘SYSIDERR’.

142

Customization Guide

Advertising