Technical data

Managing the Queue Manager and Queue Database
13.7 Stopping and Restarting the Queue Manager
Once you enter STOP/QUEUE/MANAGER/CLUSTER, the queue manager
process remains stopped; requests to that queue manager are denied until you
restart the queue manager by entering START/QUEUE/MANAGER. (Note that
the queue system remains running as long as one or more queue managers are
running.)
OpenVMS Cluster transitions do not change the state of the queue manager.
Newly available nodes do not attempt to start the queue manager (unless you
enter START/QUEUE/MANAGER).
Use the /CLUSTER qualifier to stop a clusterwide queue manager. If you enter
the obsolete command STOP/QUEUE/MANAGER (without the /CLUSTER
qualifier), the command performs the same function as STOP/QUEUES/ON_
NODE. (Use STOP/QUEUES/ON_NODE to stop all queues on a single node
without stopping the queue manager.)
13.7.2 Restarting the Queue Manager
The queue manager restarts automatically whenever you reboot the system.
However, you might need to enter START/QUEUE/MANAGER for one of the
following reasons:
• If STOP/QUEUE/MANAGER/CLUSTER has been executed, enter
START/QUEUE/MANAGER to restart the queue manager.
• In an OpenVMS Cluster environment, enter START/QUEUE/MANAGER with
the /ON qualifier to modify the list of preferred nodes on which the queue
manager can run. For more information, see Section 13.6.
• In an OpenVMS Cluster environment, enter START/QUEUE/MANAGER
to ensure that the queue manager process executes on the most preferred,
available node. If it does not, the queue manager will be moved to the most
preferred, available node without interruption of service. If you are using the
default node list (*), the queue manager will not be moved.
How to Perform This Task
To restart the queue manager, use a command in the following format:
START/QUEUE/MANAGER[/ON=(node,...)] [dirspec]
Specify the /ON=(node,...) qualifier and dirspec parameter only if you want to
change the value you are currently using for the qualifier or parameter. The
command you enter to start the queue manager is stored in the queue database,
with any qualifier or parameter you specify. If you do not specify a qualifier or
parameter, the queue manager is started using the node list and location (if any)
stored in the queue database.
If the queue manager does not start, see Section 13.11.1 for a troubleshooting
checklist.
13.8 Using Multiple Queue Managers
You can use multiple queue managers to distribute the batch and print work load
among nodes and disk volumes. You need to understand what multiple queue
managers are and how to create additional queue managers.
13–10 Managing the Queue Manager and Queue Database