Exit XICREQ

This exit is invoked at the beginning of the interval control program, before request analysis.

When invoked
At the beginning of the interval control program, before request analysis.
Exit-specific parameters
UEPICQID
Address of an 8-byte field containing the request ID parameter on request. See notes 1 and 2.
UEPICTID
Address of a 4-byte field containing the terminal ID, if any, specified on an EXEC CICS START command. See notes 1 and 2.
UEPICTI
Address of 4 bytes containing the transaction ID specified on an EXEC CICS® START command. See notes 1 and 2.
UEPICRQ1
Address of a 1-byte field containing a copy of TCAICTR, the first request code field for requests to the interval control program.
UEPICRQ2
Address of a 1-byte field containing a copy of TCAICTR2, the second request code field for requests to the interval control program.
UEPICRT
Address of a 4-byte field containing the expiry time or interval, in packed decimal format. The value is in the form 0HHMMSSF, where H=hours, M=minutes, S=seconds, and F is a positive sign.
Note:
  1. The contents of the fields addressed by UEPICQID and UEPICTID are unpredictable if the associated data items were not specified on the request. You must test the copy of TCAICTR to determine whether they contain meaningful values.
  2. Your exit program can change the values of the fields addressed by UEPICQID, UEPICTID UEPICTI, and UEPICRT. Changing the values of the fields addressed by UEPICRQ1 or UEPICRQ2 has no effect.
Return codes
UERCNORM
Continue processing.
UERCPURG
Task purged during XPI call.
XPI calls
The following must not be used:
  • ADD_SUSPEND
  • DELETE_SUSPEND
  • DEQUEUE
  • ENQUEUE
  • RESUME
  • SUSPEND
  • WAIT_MVS.