Designing an XISQUE global user exit program
- Control of the number of tasks (and the amount of associated resource) that are waiting in a queue for a free IPIC session. Waiting tasks can degrade the performance of the local system.
- Detect poor response from the remote system and notify the operator (or automatic operations program).
- Cause CICS to issue a message when the IPCONN resumes normal operation.
- Avoid false diagnosis of connection problems by distinguishing poor response times from a complete bottleneck
- Ensure that a link resumes normal operation quickly and without operator intervention after a problem in a remote system is resolved
Using IPCONN statistics
In reaching its decisions about which requests to reject, which to queue, and which queues to purge, your exit program will probably take into account the number of allocate requests currently queued against the connection. All allocate requests for a particular IPCONN are queued in a single queue that is specific to that IPCONN. CICS makes the total number of entries in this queue available in the IPCONN statistics field ISR_CURRENT_QUEUED_ALLOCATES. Your exit program can access this field by means of the address of the IPCONN statistics, which is passed in the UEPCONST exit-specific parameter.
Sample XISQUE exit program
CICS provides a sample XISQUE exit program, DFH$XISQ, that you can use as the basis for your own program. It is supplied in the CICSTS54.CICS.SDFHSAMP library. The DSECT used by the sample program to map the area addressed by UEPISDATA is called DFHXIQDS, and is supplied in the CICSTS54.CICS.SDFHMAC library.
For more information about DFH$XISQ, see Session queue management sample exit program for IPIC connections: DFH$XISQ.