HP OpenVMS DCL Dictionary
Deletes a print or batch queue created by the INITIALIZE/QUEUE command,
and deletes all the jobs in the queue. The /QUEUE qualifier is required.
Requires manage (M) access to the queue.
Specifies the name of the queue to be deleted.
To delete a queue, use the following procedure:
- Stop the specified queue by using the STOP/QUEUE/NEXT command.
The STOP/QUEUE/NEXT command stops the specified queue after all
executing jobs have completed processing. Wait for any executing jobs
to complete processing.
- Make sure that there are no outstanding references to the specified
If a generic queue refers to the specified queue as a target
execution queue, you must remove the specified queue from the list of
target execution queues.
If a logical queue refers to the specified
queue, you must deassign the logical queue.
If the specified queue
is a generic queue, jobs that were entered initially on the generic
queue and still exist on any of its target queues count as references
to the specified queue. Before you can delete the specified queue, you
must delete any jobs that were submitted originally to the specified
queue and are executing on its target queues, or you must wait until
these jobs have completed processing.
- To move jobs from the specified queue to another queue, use the SET
ENTRY/REQUEUE or ASSIGN/MERGE commands. Any jobs that remain in the
specified queue are deleted when the queue is deleted.
- Enter the DELETE/QUEUE command.
Controls whether the DELETE/QUEUE command displays the name of each
queue after it is deleted.
$ INITIALIZE/QUEUE/DEFAULT=FLAG/START/ON=LPA0 LPA0_QUEUE
$ STOP/QUEUE/NEXT LPA0_QUEUE
$ DELETE/QUEUE LPA0_QUEUE
In this example, the first command initializes and starts the printer
queue LPA0_QUEUE. The STOP/QUEUE/NEXT command stops the queue. The
DELETE/QUEUE command deletes the queue.