Filter
Top Products
v For dynamically-routed transactions—only dynamically-routed
(non-terminal-related) START requests cause the exit to be invoked. Thus, a
dynamically-routed transaction that was initiated by a terminal-related EXEC
CICS START command does not cause the exit to be invoked.
v If it is disabled.
v If an XICEREQ exit program chooses to bypass the request.
You can 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. To do
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 RESUNAVAIL condition 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. Your exit program can set a return code, but not change
any parameters.
For guidance information about dynamically routing non-terminal-related EXEC
CICS START requests, see the CICS Intercommunication Guide. For
information about writing a distributed routing program to route
non-terminal-related EXEC CICS START REQUESTS, see “Routing
non-terminal-related START requests” on page 637.
XICEREQC
XICEREQC is invoked after an interval control program request has completed.
Using XICEREQC, you can:
v Analyze the request, to determine its type, the keywords specified, and their
values.
v Set 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:
v The address of the command-level parameter structure (UEPCLPS)
v The address of a token (UEPICTOK) used to pass 4 bytes of data from
XICEREQ to XICEREQC
v The addresses of copies of six pieces of return code, resource, date, and time
information from the EIB
v The address of a token (UEPTSTOK) that is valid throughout the life of a task
v The address of an exit recursion count (UEPRECUR).
Exit XICEREQ
When invoked
Before CICS processes an interval control API request.
146 Customization Guide