TSSH gate, READ_NEXT_SET function

This function increments the queue's read cursor by one and reads that item number into a storage area obtained by TS.

Input Parameters

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.
ITEM_NUMBER
returns the number of the item just read.
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.


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