Technical data

Managing the Queue Manager and Queue Database
13.3 Specifying the Location of the Queue Database
13.3 Specifying the Location of the Queue Database
You might need to specify a location for queue database files other than the
default location of SYS$COMMON:[SYSEXE] for one of the following reasons:
• In an OpenVMS Cluster environment with multiple system disks, the default
location does not work because it has a different physical location on each
system disk. You need to store the files on a disk that is shared by all cluster
member nodes.
You must also make sure the disk holding the master file,
QMAN$MASTER.DAT, is available to all nodes using the queue database at
the beginning of system startup.
• To save space on the system disk or to help improve performance. Moving
just the queue and journal files is usually sufficient.
Ways to Move Queue Database Files
You can move queue database files in either of the following ways:
• When you create the queue database files the first time, create them in an
alternate location:
1. Define the logical name QMAN$MASTER in the SYLOGICALS.COM
command procedure (to specify where the master file is to be created).
2. Start the queue manager with the START/QUEUE/MANAGER command,
specifying the dirspec parameter (to specify where the queue and journal
files are to be created).
For detailed information, see Section 13.5.
• If you previously created the files in the default location:
1. Stop the queue manager.
2. Copy the files to the new location.
3. Verify that the files have been successfully copied to the new location, and
then delete the files in the old location.
4. If you move the master file, define the logical name QMAN$MASTER on
all nodes (to specify where the master file is located), and add this logical
name definition to SYLOGICALS.COM on all nodes.
5. Restart the queue manager with the START/QUEUE/MANAGER
command, specifying the dirspec parameter (to specify where the queue
and journal files are located).
Section 13.3.1 explains how to specify the location of the master file;
Section 13.3.2 explains how to specify the locations of queue and journal files.
13.3.1 Specifying the Location of the Queue Master File
To specify the location of the queue master file, perform the following steps before
starting the queue manager:
1. Enter a command in the following format:
DEFINE/SYSTEM/EXECUTIVE_MODE QMAN$MASTER equivalence-name
where equivalence-name specifies the device and directory where the master
file is to be created or located.
Managing the Queue Manager and Queue Database 13–5