HP OpenVMS System Manager's Manual, Volume 1:...

Managing the Queue Manager and Queue Database

Displaying Information About Queue Managers

Customizing Queue Manager Failover

Starting the Queue Manager and Creating a Queue Database  

where:

/NEW_VERSION	Specifies that new queue database files are to be created: Master file Queue file Journal file Specify the /NEW_VERSION qualifier only if you want to create new database files. If your queuing system is already functioning, creating new database files is not necessary.
/ON= (node,...)	Allows you to customize failover of the queue manager. For more information, see Customizing Queue Manager Failover.
dirspec	Specifies the location of the queue and journal files, as explained in Specifying the Location of Queue and Journal Files. Use this parameter if you are creating the queue and journal files in a location other than the default.

Specify the /NEW_VERSION qualifier only if you do not have a currently functioning queue database. If you specify this qualifier and you already have queue database files, the system overwrites your current queue database files.

The job controller automatically starts the queue manager during reboot unless you enter a STOP/QUEUE/MANAGER/CLUSTER command. For this reason, including START/QUEUE/MANAGER in your startup command procedure is unnecessary.

This section describes how to start the queue manager and create the queue database files on systems and clusters with a single system disk. For systems in a cluster with multiple system disks, including mixed-architecture OpenVMS Cluster systems, you must prepare a shared environment, as described in Chapter 5 of OpenVMS Cluster Systems .

1. Make sure the values of the system address parameters SCSNODE and SCSSYSTEMID match the DECnet for OpenVMS node name and node ID. These values must be correctly defined for the queuing system to operate correctly:
   • The PARAMETERS SHOW command of the System Management utility (SYSMAN) determines the value of the system address parameters SCSNODE and SCSSYSTEMID.
   
   
   
   • The Network Control Program (NCP) SHOW EXECUTOR SUMMARY command shows the DECnet for OpenVMS node name and node ID.
   For more specific instructions, see the second example in Investigating the Problem.
2. To create queue database files in the default location, SYS$COMMON:[SYSEXE], go to step 3.
   
   To create queue database files in a location other than the default, follow the instructions in Specifying the Location of the Queue Master File or Specifying the Location of Queue and Journal Files, or both.
3. To start the queue manager and create queue database files, enter a START/QUEUE/MANAGER command. This command starts the queue manager process and, optionally, creates queue and journal files.

If the queue manager does not start, see Avoiding Common Problems: A Troubleshooting Checklist for a troubleshooting checklist.

Example

The following example specifies that:

• The master file is to located in the directory DUA4:[MASTER].



• The queue and journal files are to be located in the directory DUA2:[SYSQUE]. (The master file, however, will remain in DUA4:[MASTER].)

$ DEFINE/SYSTEM/EXECUTIVE_MODE QMAN$MASTER DUA4:[MASTER]
$ MOUNT/SYSTEM/NOASSIST DUA4:
$ !
$ ! Add the two previous commands to SYLOGICALS.COM
$ !
$ START/QUEUE/MANAGER/NEW_VERSION DUA2:[SYSQUE]

Displaying Information About Queue Managers

Customizing Queue Manager Failover