NQED gate, DEQUEUE function
This functions releases an active enqueue owned by the current UOW from the specified enqueue pool.
Input Parameters
- ENQUEUE_NAME1
- Optional Parameter
- A block (addr,len) identifying the name of the enqueue being released. Or alternatively identifies the prefix of the enqueue name which when combined with the ENQUEUE_NAME2 parameter forms the name of the enqueue being released.
- ENQUEUE_NAME2
- Optional Parameter
- A block (addr,len) identifying the second half of the enqueue name.
- ENQUEUE_TOKEN
- Token representing the enqueue that is to be released. Slightly better performance is achieved for callers that use the token method for releasing their enqueues.
- MAX_LIFETIME
- Optional Parameter
- Indicates the maximum duration of the enqueue being released.
- DISPATCHER_TASK
- The enqueue will be released if it is held when a DEQUEUE_ALL request is issued by the owning dispatcher task. This is the only value permitted when POOL_TOKEN is not supplied on the call.
- TRANSACTION
- The enqueue was acquired with a duration of the last UOW of the current transaction.
- UOW
- The enqueue was acquired with a duration of the current UOW. This is the default value when not supplied on the call.
- Values for the parameter are:
- DISPATCHER_TASK
- TRANSACTION
- UOW
- POOL_TOKEN
- Optional Parameter
- Token representing enqueue pool from which the enqueue is to be released.
Output Parameters
- REASON
- The values for the parameter are:
- ENQUEUE_LOCKED
- ENQUEUE_NOT_OWNED
- INVALID_POOL_TOKEN
- RESPONSE
- Indicates whether the domain call was successful. For more information, see RESPONSE parameter on domain interfaces.