TSPT gate, PUT function

If the queue does not already exist, this function creates a queue with the single item provided.

Input Parameters

ITEM_DATA
is the address and length of the item being written.
QUEUE_NAME
is the name of the queue being created or appended to.
SUSPEND
indicates whether or not the request will be suspended if there is insufficient auxiliary storage to satisfy the request. This option is ignored if the queue is in main storage.
Values for the parameter are:
  • NO
  • YES
BMS
Optional Parameter
indicates whether or not BMS owns this queue.
Values for the parameter are:
  • NO
  • YES
FMH
Optional Parameter
indicates whether the data contains an FMH.
Values for the parameter are:
  • NO
  • YES
IC
Optional Parameter
this option indicates whether or not Interval Control owns this queue. If the queue already exists and is an IC queue then IC(YES) must be specified on the request. Otherwise an INVALID response is returned.
Values for the parameter are:
  • NO
  • YES
IC_DATA
Optional Parameter
is the address and length of an optional ICE.

Output Parameters

REASON
The following values are returned when RESPONSE is EXCEPTION:
  • DUPLICATE_NAME
  • INSUFFICIENT_STORAGE
  • INVALID_LENGTH
  • INVALID_QUEUE_NAME
  • INVALID_QUEUE_TYPE
  • IO_ERROR
  • LOCKED
  • QUEUE_DELETED
  • QUEUE_FULL
  • QUEUE_REMOTE
QUEUE_CREATION_TIME
returns the store clock time at which the queue was created.
RECOVERABLE
returns whether the queue is recoverable or not.
Values for the parameter are:
  • NO
  • YES
RESPONSE
Indicates whether the domain call was successful. For more information, see RESPONSE parameter on domain interfaces.


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