vFor dynamically-routed transactions—only dynamically-routed
(non-terminal-related) STARTrequests cause the exit to be invoked. Thus, a
dynamically-routed transaction that was initiated by a terminal-related EXEC
CICS STARTcommand does not cause the exit to be invoked.
vIf it is disabled.
vIf an XICEREQ exit program chooses to bypass the request.
Youcan use XICERES to check that all resources required by the transaction to
be started are available on the target region. If, for example, the transaction is
disabled, or a required file is missing, your exit program can give the distributed
routing program the opportunity to route the request to a different region. Todo
this, set a return code of UERCRESU. This causes CICS to:
1. Set the DYRERROR field of the distributed routing program’s
communications area to 'F'—resource unavailable.
2. Reinvoke the routing program, on the routing region, for route selection
failure.
3. Return a RESUNAVAILcondition on the EXEC CICS START command
executed by the mirror on the target region. (This condition is not returned
to the application program.)
CICS ignores any changes made by the exit program to the values of any of
the exit parameters. Yourexit program can set a return code, but not change
any parameters.
For guidance information about dynamically routing non-terminal-related EXEC
CICS STARTrequests, see the CICS Intercommunication Guide. For
information about writing a distributed routing program to route
non-terminal-related EXEC CICS STARTREQUESTS, see “Routing
non-terminal-related STARTrequests” on page 637.
XICEREQC
XICEREQC is invoked after an interval control program request has completed.
Using XICEREQC, you can:
vAnalyze the request, to determine its type, the keywords specified, and their
values.
vSet return codes for the EIB.
Note: The XICEREQC exit is invoked by internal requests made by CICS code,
as well as by requests made by applications.
Parameters passed to each of the exits
CICS passes ten parameters to these exits as follows:
vThe address of the command-level parameter structure (UEPCLPS)
vThe address of a token (UEPICTOK) used to pass 4 bytes of data from
XICEREQ to XICEREQC
vThe addresses of copies of six pieces of return code, resource, date, and time
information from the EIB
vThe address of a token (UEPTSTOK) that is valid throughout the life of a task
vThe address of an exit recursion count (UEPRECUR).
Exit XICEREQ
When invoked
Before CICS processes an interval control API request.
146 Customization Guide