TSSH gate, READ_SET function
This function reads the specified queue item into a storage area obtained by TS. The read cursor for the queue is set to the input item number.
Input Parameters
- ITEM_NUMBER
- is the number of the item to be updated.
- QUEUE_NAME
- is the name of the queue being created or appended to.
- POOL_TOKEN
- Optional Parameter
- is a token for the shared TS pool.
- TRANSACTION_NUMBER
- Optional Parameter
- is the 4-byte transaction number (in packed-decimal format).
Output Parameters
- REASON
- The following values are returned when RESPONSE is EXCEPTION:
- INVALID_QUEUE_NAME
- IO_ERROR
- ITEM_NOT_FOUND
- QUEUE_NOT_FOUND
- SERVER_ERROR
- FMH
- indicates whether the data contains an FMH.
- Values for the parameter are:
- NO
- YES
- ITEM_DATA
- returns the address and length of the item data.
- RESPONSE
- Indicates whether the domain call was successful. For more information, see RESPONSE parameter on domain interfaces.
- TOTAL_ITEMS
- is the total number of items in the queue on completion of the operation.