Exit XISQLCL
Exit XISQLCL is invoked after a function shipping request of a START NOCHECK or START NOCHECK PROTECT command over IPIC fails 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 XISQUE exit program specifies that the request is not queued in the issuing region.
- Exit-specific parameters
- The DSECT, DFHXILDS, is provided for this parameter list.
- UEPISQPL
- Address of a parameter list that contains the following fields:
- UEPPLIST
- The address of the parameter list for the command.
- UEPQLEN
- A halfword binary field containing the number of items currently on the queue.
- UEPIPCNM
- The eight-byte name of the IPCONN.
- UEPTRID
- The four-byte identifier of the local transaction name, or blanks if SYSID is specified in the command. Your program can use the transaction manager XPI call, INQUIRE_TRANDEF, to obtain details of the local transaction. See The INQUIRE_TRANDEF call.
- Return codes
-
- UERCSYS
- Take the system action. This action 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)
- A SYSIDERR error message 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 a SYSIDERR response.
- UERCPURG
- Task purged during XPI call.
- XPI calls
- All can be used.
- API and SPI calls
- None can be used.
Important
There is no UERCNORM return code at this exit point, because the exit is invoked after a failure. You must choose whether to take the system default action or to handle the error in some other way.
The sample XISQLCL global user exit program, DFH$XISL, is provided.