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.
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:
Define the logical
name QMAN$MASTER in the SYLOGICALS.COM command procedure (to specify where
the master file is to be created).
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).
If you previously created the files in the default
location:
Stop the queue
manager.
Copy the files to the new location.
Verify that the files have been successfully copied
to the new location, and then delete the files in the old location.
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.
Restart the queue manager with the START/QUEUE/MANAGER
command, specifying the dirspec parameter (to
specify where the queue and journal files are located).
To specify the location of the queue master file, perform
the following steps before starting the queue manager:
Enter a command
in the following format:DEFINE/SYSTEM/EXECUTIVE_MODE QMAN$MASTER equivalence-namewhere equivalence-name specifies the
device and directory where the master file is to be created or located.
In
an OpenVMS Cluster environment, enter this command on every node
in the cluster.
In an OpenVMS Cluster environment, the directory you
specify for the master file must be available to all nodes in the
cluster. If the directory specification is a concealed logical name,
you must define it identically on all nodes in the cluster; you
must also mount the disk on all cluster member nodes early
in system startup.
On every node in the OpenVMS Cluster environment,
add the command that you entered in step 1 to SYS$MANAGER:SYLOGICALS.COM.
If the location you specify is on a disk other than
the node's system disk, add a command in SYLOGICALS.COM to mount
the disk. SYLOGICALS.COM is normally used to define logical names; however,
it is important that SYLOGICALS.COM contain the command to mount
the disk holding the master file so that the master file is available
before the job controller starts the queue manager.
Specifying the Location of Queue and Journal
Files
Specify the location
of queue and journal files with the dirspec parameter
to the START/QUEUE/MANAGER command. For example:
$ START/QUEUE/MANAGER DUA2:[SYSQUE]
This command specifies that the queue and journal files are
to be located in the directory DUA2:[SYSQUE].
In an OpenVMS Cluster environment, the directory you
specify for the queue and journal files must be available to all
nodes that can run the queue manager. If the directory specification
is a concealed logical name, you must define it identically on all
nodes in the cluster. You must also mount the disk on all nodes
capable of running the queue manager.
The directory location you enter with START/QUEUE/MANAGER
is stored in the queue database master file and becomes the default.
Therefore, if you must restart the queue manager, you do not need
to respecify this directory location.