Technical data

Managing the Queue Manager and Queue Database
13.8 Using Multiple Queue Managers
13.8.1 Understanding Multiple Queue Managers
Explanations of items related to the operation of multiple queue managers
follow.
Restrictions on Using Multiple Queue Managers
Multiple queue managers have the following restrictions:
• Queues running on one queue manager cannot reference queues running
on a different queue manager. For example, a generic queue running on
queue manager A cannot direct jobs to an execution queue running on queue
manager B.
• You cannot move a job from a queue on one queue manager to a queue on a
different queue manager.
• The operating system allows a maximum of five queue managers in an
OpenVMS Cluster environment.
Names of Multiple Queue Managers
The process name for a queue manager is the first twelve characters of the queue
manager name. The default queue manager name is SYS$QUEUE_MANAGER;
the default queue manager process name is QUEUE_MANAGE. If you create
an additional queue manager named PRINT_MANAGER, the process name is
PRINT_MANAGE.
Know the process names of all your queue managers so that you can troubleshoot
queue manager problems, as explained in Section 13.11.
Multiple Queue Managers’ Use of Queue Database Files
Multiple queue managers share a single master file. However, a queue database
with multiple queue managers contains a queue file and a journal file for each
queue manager, as explained in Section 13.2.
Commands for Managing Multiple Queue Managers
By default, the following commands affect the default queue manager
SYS$QUEUE_MANAGER or the queues running on the default queue manager:
• START/QUEUE/MANAGER
• ENABLE AUTOSTART/QUEUES and DISABLE AUTOSTART/QUEUES
• STOP/QUEUES/ON_NODE
• STOP/QUEUE/MANAGER/CLUSTER
• DELETE/QUEUE/MANAGER
The /NAME_OF_MANAGER qualifier allows you to specify a different queue
manager for these commands.
13.8.2 Creating Additional Queue Managers
To create one or more additional queue managers, follow these steps:
1. Follow steps 1 and 2 in Section 13.5.
2. To create an additional queue manager, enter a command in the following
format:
START/QUEUE/MANAGER/ADD/NAME_OF_MANAGER=name[/ON=(node,...)] [dirspec]
Managing the Queue Manager and Queue Database 13–11