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.


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