[an error occurred while processing this directive]

HP OpenVMS Systems Documentation

Content starts here

HP OpenVMS DCL Dictionary


Previous Contents Index


STOP/QUEUE

The STOP/QUEUE command causes the specified execution queue to pause. All jobs currently executing in the queue are suspended (until the queue is restarted with the START/QUEUE command), and no new jobs are initiated. The /QUEUE qualifier is required.

Requires manage (M) access to the queue.


Format

STOP/QUEUE queue-name[:]


Parameter

queue-name[:]

Specifies the name of the queue that you want to pause.

Description

The STOP/QUEUE command causes the specified queue to pause. All jobs currently executing in the queue are suspended. No new jobs are initiated.

Use the START/QUEUE command to release the queue from the paused state. When you restart the queue, any jobs that were executing resume executing at the point where they left off, unless you use the /BACKWARD, the /FORWARD, the /SEARCH, or the /TOP_OF_FILE qualifier to restart a print job at a different place.

For information about how to stop a queue, see the following commands:

STOP/QUEUE/ABORT
STOP/QUEUE/ENTRY
STOP/QUEUE/MANAGER/CLUSTER
STOP/QUEUE/NEXT
STOP/QUEUE/REQUEUE
STOP/QUEUE/RESET
STOP/QUEUES/ON_NODE

Examples

#1

$ STOP/QUEUE LPA0
      

The STOP/QUEUE command in this example suspends the current print job in the queue LPA0 and places that queue in the paused state.

#2

$ STOP/QUEUE JADE_PRINT
$ START/QUEUE/TOP_OF_FILE JADE_PRINT
      

The STOP/QUEUE command in this example suspends the job that is currently printing on the printer queue JADE_PRINT and places that queue in the paused state. The START/QUEUE command releases the queue from the paused state. The /TOP_OF_FILE qualifier causes the job that was suspended to resume printing at the beginning of the file rather than at where it was interrupted.


Previous Next Contents Index