The DEQUEUE statement releases resources acquired by the issuing task with an ENQUEUE request. Acquired resources not released explicitly with a DEQUEUE request are released automatically at task termination.
►►─── DEQUEUE ─┬─── ALL ──────────────────────────────────────────────┬─ ; ───►◄ │ ┌──────────────────────────────────────────────────┐ │ └─▼─ NAME (resource-id) LENGTH (resource-id-length) ─┴─┘
Releases all resources acquired by the issuing task by means of ENQUEUE requests.
Specifies the resources to be dequeued and supplies the length of each resource: Resource-id is the symbolic name of a user-defined field that contains the 1- to 255-character resource ID. Multiple NAME parameters must be separated by at least one blank.
Specifies either the symbolic name of a user-defined FIXED BINARY(31) field that contains the length of the resource ID, or the length itself expressed as a numeric constant.
The following statement releases all the resources enqueued by the issuing task:
DEQUEUE NAME (PAYROLL_LOCK)
LENGTH (16);
Upon completion of the DEQUEUE function, the ERROR_STATUS field in the IDMS DC communications block indicates the outcome of the operation:
The request has been serviced successfully.
At least one resource ID cannot be found; all resources that were located have been dequeued.
The parameter list is invalid.
|
Copyright © 2014 CA.
All rights reserved.
|
|