Exit XTSQRIN

Exit XTSQRIN is invoked before execution of a user temporary storage interface request for a user TS queue (for example, a WRITEQ TS, or READQ TS request).

Exit-specific parameters
UEPTRANID
Address of the 4-byte transaction ID.
UEPUSER
Address of the 8-byte user ID.
UEPTERM
Zero, or the address of the 4-byte terminal ID. If no address is returned, this could mean that this request has been function shipped over an IPIC connection.
UEPPROG
Address of the 8-byte application program name.
UEP_TS_FUNCTION
Address of a byte containing the function:
  • UEP_TS_FUN_WRITE
  • UEP_TS_FUN_REWRITE
  • UEP_TS_FUN_READ_INTO
  • UEP_TS_FUN_READ_SET
  • UEP_TS_FUN_READ_NEXT_INTO
  • UEP_TS_FUN_READ_NEXT_SET
  • UEP_TS_FUN_DELETE
UEP_TS_QUEUE_NAME
Address of a 16-byte field containing the queue name.
UEP_TS_DATA_P
Address of a fullword containing the address of the data. (Write and rewrite requests).
UEP_TS_DATA_L
Address of a fullword containing the length of the data. (Write and rewrite requests).
UEP_TS_ITEM_NUMBER
Address of a fullword containing the item number. (Rewrite, read_into and read_set requests).
UEP_TS_STORAGE_TYPE
Address of a byte containing the storage type. (Write requests).

On input to the exit, the parameter will be set to either UEP_TS_STORAGE_TYPE_MAIN or UEP_TS_STORAGE_TYPE_AUX_TST. This parameter may be modified by the exit to any of the following values.

Note that if CICS® has been initialized with TS main-only support, setting this parameter has no effect. See the description of the TS system initialization parameter for more information.

UEP_TS_STORAGE_TYPE_MAIN
Main storage.
UEP_TS_STORAGE_TYPE_AUX_TST
Auxiliary storage (recoverability determined by the resource definition).
UEP_TS_STORAGE_TYPE_AUX_RECOV_YES
Auxiliary storage (recoverable).
UEP_TS_STORAGE_TYPE_AUX_RECOV_NO
Auxiliary storage (non-recoverable).
Return codes
UERCNORM
Normal.
UERCPURG
Purged.
XPI calls
All can be used.
API and SPI calls
None can be used.


dfha3fv.html | Timestamp icon Last updated: Monday, 5 June 2017