Technical data

Managing the Queue Manager and Queue Database
13.8 Using Multiple Queue Managers
where:
/ADD Creates an additional queue manager in the existing
master file and creates new queue and journal files
/NAME_OF_
MANAGER=name
Creates a non-default queue manager with a name up
to 31 characters long. You can create a maximum of five
queue managers.
/ON=(node,...) Allows you to customize failover of the queue manager.
For more information, see Section 13.6.
dirspec Specifies the location of the queue and journal files, as
explained in Section 13.3.2. Use this parameter if you are
creating the queue and journal files in a location other
than the default.
Caution
Do not specify the /NEW_VERSION qualifier when you create an
additional queue manager: multiple queue managers share a single
master file. An additional queue file and journal file are created
automatically for each additional queue manager.
Example
The command in the following example creates and starts a new queue manager
named BATCH_MANAGER.
$ START/QUEUE/MANAGER/ADD/NAME_OF_MANAGER=BATCH_MANAGER/ON=(A,B,*) DUA2:[QUEUES]
13.8.2.1 Creating and Moving Queues with Multiple Queue Managers
When you create a queue with the INITIALIZE/QUEUE command, specify
the name of the queue manager on which it is to run by including the
/NAME_OF_MANAGER qualifier. If you do not specify the /NAME_OF_
MANAGER qualifier, the queue is created to run on the default queue manager,
SYS$QUEUE_MANAGER.
To move an existing queue from its original queue manager to a different queue
manager, delete the queue with the DELETE/QUEUE command and re-create the
queue with the INITIALIZE/QUEUE command.
13.8.2.2 Maintaining Queue Managers
When entering DCL commands to maintain the queue manager, be sure to
specify the /NAME_OF_MANAGER qualifier to specify the queue manager
to which the command is to apply. If you do not specify the /NAME_OF_
MANAGER qualifier, the command is executed on the default queue manager,
SYS$QUEUE_MANAGER.
Example
In the following example:
• The first command creates and starts the queue manager PRINT_MANAGER
and creates master, queue, and journal files.
• The second command creates and starts an additional queue manager,
BATCH_MANAGER; queue and journal files are created for it automatically.
• The default queue manager SYS$QUEUE_MANAGER is not defined.
13–12 Managing the Queue Manager and Queue Database