The DELETE QUEUE statement deletes all or part of a queue. If only one queue record is deleted, the system maintains currency within the queue by saving the next and prior currencies of the deleted record.
►►─── DELETE QUEUE ─┬─────────────────┬─┬─────────────┬─ ; ──────────────────►◄ └─ ID (queue-id) ─┘ ├─ CURRENT ◄ ─┤ └─ ALL ───────┘
Specifies the 1- to 16-character ID of the queue that contains the record to be deleted. Queue-id is either the symbolic name of a user-defined field that contains the ID or the ID itself enclosed in single quotation marks. If the queue ID is not specified, a blank ID is assumed.
Deletes the current record of the queue associated with the requesting task. CURRENT is the default.
Deletes all records in the queue and the queue header id.
The following statement deletes the current record in the RES_Q queue:
DELETE QUEUE
ID ('RES_Q')
CURRENT;
Upon completion of the DELETE QUEUE function, the ERROR_STATUS field in the IDMS DC communications block indicates the outcome of the operation:
The request has been serviced successfully.
The requested queue header record cannot be found.
The requested queue record cannot be found.
No resource control element (RCE) exists for the queue record, indicating that currency has not been established.
A database error occurred during queue processing. A common cause is a DBKEY deadlock. For a PUT QUEUE operation, this code can also mean that the queue upper limit has been reached.
If a database error has occurred, there are usually be other messages in the CA-IDMS/DC/UCF log indicating a problem encountered in RHDCRUAL, the internal Run Unit Manager. If a deadlock has occurred, messages DC001000 and DC001002 are also produced.
The parameter list is invalid.
|
Copyright © 2014 CA.
All rights reserved.
|
|