 |
HP OpenVMS DCL Dictionary
DELETE/QUEUE
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.
Format
DELETE/QUEUE queue-name[:]
Parameter
queue-name[:]
Specifies the name of the queue to be deleted.
Description
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
queue.
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.
Qualifier
/LOG
/NOLOG (default)
Controls whether the DELETE/QUEUE command displays the name of each
queue after it is deleted.
Example
|
$ 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.
|
