Filter
Top Products
IC_EIDOPT8
X'20' Unused by CICS.
The EID is reset to its original value before return to the application program. That
is, changes made to the EID are retained for the duration of the interval control
request only.
Note: Your user exit program is prevented from making major changes to the EID.
However, you must take great care when making the minor modifications
that are permitted.
Using the interval control request token UEPICTOK: UEPICTOK provides the
address of a 4-byte area that you can use to pass information between the
XICEREQ and XICEREQC user exits for the same interval control request. For
example, the address of a piece of storage obtained by the XICEREQ user exit,
which is to be freed by the XICEREQC exit, can be passed in the UEPICTOK field.
Using the task token UEPTSTOK: UEPTSTOK provides the address of a 4-byte
area that you can use to pass information between successive interval control
requests in the same task. (By contrast, UEPICTOK is usable only for the duration
of a single interval control request, because its contents may be destroyed at the
end of the request.) For example, if you need to pass information between
successive invocations of the XICEREQ exit, UEPTSTOK provides a means of
doing this.
The EIB:
Copies of EIBRSRCE, EIBRCODE, EIBRESP, and EIBRESP2 are passed to the
exit, so that you can:
v Modify or set completion and resource information in XICEREQ and XICEREQC
v Examine completion and resource information in XICEREQC.
You can update the copies of EIBRSRCE, EIBRCODE, EIBRESP, and EIBRESP2
that you are given in the parameter list. Interval control copies your values into the
real EIB after the completion of XICEREQC; or if you specify a return code of
‘bypass’ in XICEREQ.
You must set valid interval control responses. You must set all three of EIBRCODE,
EIBRESP, and EIBRESP2 to a consistent set of values, such as would be set by
CICS interval control to describe a valid completion. CICS does not police the
consistency of EIBRCODE, EIBRESP, and EIBRESP2. However, if EIBRCODE is
set to a non-zero value and EIBRESP is set to zero, CICS overrides EIBRESP with
a non-zero value. To aid you in setting the values of EIBRCODE, EIBRESP, and
EIBRESP2, the values used by interval control are specified in DFHICUED.
Example of how XICEREQ and XICEREQC can be used: XICEREQ and
XICEREQC can be used for a variety of purposes. One example of a possible use
is given below.
In this example, XICEREQ and XICEREQC are used to route START requests to a
number of different CICS regions to provide a simple load balancing mechanism.
The example shows only the capabilities of the exits; it is not intended to indicate
an ideal way of achieving the function.
In XICEREQ:
Chapter 1. Global user exit programs 161