skip book previous and next navigation links
go up to top of book: HP OpenVMS System Manager's Manual, Volume 1:... HP OpenVMS System Manager's Manual, Volume 1:...
go to beginning of chapter: Managing the Queue Manager and Queue Database Managing the Queue Manager and Queue Database
go to previous page: Understanding the Queue Database Understanding the Queue Database
go to next page: Displaying Information About Queue ManagersDisplaying Information About Queue Managers
end of book navigation links

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:

Ways to Move Queue Database Files

You can move queue database files in either of the following ways:

Specifying the Location of the Queue Master File explains how to specify the location of the master file; Specifying the Location of Queue and Journal Files explains how to specify the locations of queue and journal files.

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-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.
    NoteIn 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.

  2. On every node in the OpenVMS Cluster environment, add the command that you entered in step 1 to SYS$MANAGER:SYLOGICALS.COM.
  3. 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.

    For more information about defining systemwide logical names in SYLOGICALS.COM, see Modifying SYLOGICALS.COM to Define Systemwide Logical Names.

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].
NoteIn 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.
go to previous page: Understanding the Queue Database Understanding the Queue Database
go to next page: Displaying Information About Queue ManagersDisplaying Information About Queue Managers