Exit

Exit XISCONA is invoked when a function shipping or DPL request is about to be queued because all bound contention winner sessions to the remote region are in use.

When invoked
When a function shipping or DPL request is about to be queued because all bound contention winner sessions to the remote region are in use.
Note: For DPL requests that are routed dynamically, the dynamic routing program is invoked before XISCONA. If there are no free sessions the routing program may choose not to queue a DPL request; in these circumstances, XISCONA is not invoked. For information about the dynamic routing of DPL requests, see Dynamically routing DPL requests.
Exit-specific parameters
UEPISPCA
Address of a parameter list containing the following fields. You can map the parameter list using the DSECT DFHXISDS.
UEPCONST
Address of the Connection statistics record.

Connection statistics records are of type STICONSR (STID value 52). Your exit program can map the record using the DSECT DFHA14DS. See notes.

UEPMODST
Address of the Mode Entry statistics record, or zero. A Mode Entry statistics record is built only if:
  • The connection-type is LU6.2 (see field UEPCONTY).
  • The profile DFHCICSF (which is always used for function shipping) defines a specific MODENAME to be used in the allocation of LU6.2 sessions.

Mode Entry statistics records are of type STICONMR (STID value 76). Your exit program can map the record (if present) using the DSECT DFHA20DS.

UEPEIPPL
Address of the request parameter list.
UEPCONTY
A 1-byte field indicating the connection-type. Possible values are:
UEPMRO (X'80')
Request for an MRO connection
UEPLU6 (X'40')
Request for an LU6.1 connection
UEPLUC (X'20')
Request for an LU6.2 connection.
UEPNETNM
An 8-character field containing the NETNAME for the connection; that is, the identifier (applid) of the remote CICS® region or system.
Note:
  1. The general format of statistics records is described in CICS statistics record format.
  2. For a list of statistics record-types and their associated copy books, see CICS statistics data section.
  3. For a description of the fields in Connection and Mode Entry statistics records, see CICS statistics in DSECTS and DFHSTUP report.
Return codes
UERCAQUE
Queue the request. This is the default.
UERCAPUR
Do not queue the request, unless local queuing is possible.
XPI calls
All can be used.

Important

There is no UERCNORM return code at this exit point, because the exit is invoked after a failure. The choice is whether or not to take the system default action of queuing the request.