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.