Technical data

Setting Up and Maintaining Queues
14.7 Maintaining Queues
14.7.1.4 Closing a Queue
When a queue is not available for an extended period of time (for example, when
a printer needs servicing), you can prevent new jobs from entering the queue
by specifying the /CLOSE qualifier with SET QUEUE, INITIALIZE/QUEUE, or
START/QUEUE. The /CLOSE qualifier prevents users from entering jobs in the
queue with PRINT or SUBMIT commands. When a user attempts to print or
submit a job to a closed queue, the job is rejected, and the user is notified that
the queue is closed. For example:
$ PRINT/QUE=$PRINTER_1 REPORT.TXT;
%PRINT-F-CREJOB, error creating job
-JBC-E-QUE_CLOSED, queue closed, jobs not accepted
Jobs currently in the queue are not affected.
When the queue is available again, use the /OPEN qualifier to open the queue for
incoming jobs.
14.7.1.5 Stopping a Queue
To stop a queue, enter one of the following commands:
Command Description
STOP/QUEUE/NEXT Lets all currently executing jobs complete and then stops
the queue. Once you enter this command, all new jobs are
prevented from executing.
STOP/QUEUE/RESET Abruptly stops the queue and returns control to the system.
Any jobs that are currently executing are stopped immediately.
If the queue is not set to retain jobs completed with an error
status, use SET QUEUE/RETAIN=ERROR to do so before
stopping the queue with STOP/QUEUE/RESET. This causes
the queue to retain information about aborted jobs.
For print jobs retained on error, use SET
ENTRY/RELEASE/NOCHECKPOINT to restart the
interrupted jobs from the beginning. Print jobs are restartable
by default; batch jobs are not restartable unless submitted
with the /RESTART qualifier.
For autostart queues, these commands deactivate a queue for autostart as
explained in Section 14.7.1.6. To restart a stopped nonautostart queue or to
reactivate a deactivated autostart queue, enter START/QUEUE.
14.7.1.6 Preventing Autostart Queues from Starting
The STOP/QUEUE/NEXT or STOP/QUEUE/RESET command stops an autostart
queue and marks it inactive for autostart until you enter START/QUEUE. This
feature prevents an autostart output queue from accidentally restarting when a
printer is being serviced.
14.7.1.7 Disabling Autostart on a Node
The DISABLE AUTOSTART/QUEUES command notifies the queue manager to
perform the following tasks on the affected node:
• Prevent autostart queues from failing over to the node.
• Mark all autostart queues on the node as ‘‘stop pending’’ in preparation for a
planned shutdown. This lets jobs currently executing on the queues complete.
14–60 Setting Up and Maintaining Queues