Technical data

Setting Up and Maintaining Queues
14.7 Maintaining Queues
• Upon completion of any jobs currently executing on one of the node’s autostart
queues, force the queue to fail over to the next available node in the queue’s
failover list on which autostart is enabled. (An autostart queue can only fail
over if you have set it up to run on more than one node.)
By default, DISABLE AUTOSTART/QUEUES affects the node from which it is
entered. Specify the /ON_NODE qualifier to disable autostart on a different node.
Use DISABLE AUTOSTART/QUEUES prior to shutting down a node. For more
information, see Section 14.7.1.9.
14.7.1.8 Stopping All Queues on a Node
To stop all queues on a node without stopping the queue manager, enter
STOP/QUEUES/ON_NODE. By default, this command affects the node on which
the command is entered. To stop queues on a different node, specify the name of
the node on which queues are to be stopped as follows:
STOP/QUEUES/ON_NODE=node
When you enter STOP/QUEUES/ON_NODE, nonautostart queues and autostart
queues without a failover list are stopped. Autostart queues created or started
with a failover list fail over to the next available node in that list that has
autostart enabled. In all cases, currently executing jobs are aborted.
However, you can allow jobs executing on autostart queues to complete by
entering the DISABLE AUTOSTART/QUEUES command and waiting for jobs
to complete before entering the STOP/QUEUES/ON_NODE command. For more
information, see Section 14.7.1.9.
14.7.1.9 Stopping Queues Before Shutting Down a System
The following commands are included in the shutdown command procedure
SYS$SYSTEM:SHUTDOWN.COM and are automatically executed when you shut
down a node using SHUTDOWN.COM:
• DISABLE AUTOSTART/QUEUES
• STOP/QUEUES/ON_NODE
Allowing Jobs to Complete Before Stopping Autostart Queues
STOP/QUEUES/ON_NODE aborts jobs and stops all queues on a node; DISABLE
AUTOSTART allows jobs on autostart queues to finish processing before failing
over or stopping autostart queues. If your configuration uses autostart queues,
you might want to allow jobs on those queues to complete before stopping your
queues.
In SHUTDOWN.COM, STOP/QUEUES/ON_NODE is executed shortly before
the node is shut down. When using SHUTDOWN.COM, you can ensure that
jobs on autostart queues have time to complete before the queues are stopped by
specifying the time interval between DISABLE AUTOSTART/QUEUES and the
shutdown.
Setting Up and Maintaining Queues 14–61