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.