Document revision date: 30 March 2001

The Audit Analysis utility (ANALYZE/AUDIT) enables system managers and site security administrators to selectively extract and display information from security audit log files. Using ANALYZE/AUDIT qualifiers, you can choose from among a variety of report formats and select the event criteria to be included in the report. Refer to the OpenVMS Guide to System Security for a description of how to use the utility.

Before you can create and start queues, you must set up the queue manager and the queue database. This chapter tells how to set up and manage the queue manager and queue database for the OpenVMS batch and print queuing system.

Information Provided in This Chapter

This chapter describes the following tasks:

Task	Section
Specifying the location of the queue database	Section 13.3
Displaying information about queue managers	Section 13.4
Starting the queue manager and creating the queue database	Section 13.5
Customizing queue manager failover	Section 13.6
Stopping and restarting the queue manager	Section 13.7
Using multiple queue managers	Section 13.8
Saving and restoring the queue database	Section 13.9
Maximizing queuing system performance	Section 13.10
Solving queue manager problems	Section 13.11
Reporting a queuing system problem to Compaq	Section 13.12

This chapter explains the following concepts:

Concept	Section
The queue manager	Section 13.1
The queue database	Section 13.2
Multiple queue managers	Section 13.8.1

Note that this chapter contains many references to DCL commands. You can find additional information about all DCL commands in the OpenVMS DCL Dictionary.

13.1 Understanding the Queue Manager

To use a printer or batch processing on your system, you must use queues. The queue manager controls queue activity. The queue database consists of a master file as well as queue and journal files, which store information about queues and jobs.

Before you can perform any queue operation, you must start the queue manager and create the queue database. Section 13.5 contains instructions for doing this.

Figure 13-1 illustrates how the queue manager works to manage queue activity in an OpenVMS Cluster environment.

Figure 13-1 OpenVMS Batch and Print Queuing System

When a user submits a batch or print job to a queue, the queue manager performs the following tasks:

1. Receives the user's queue request, including information about the type of job, the file name or names, the name of the queue, and any special options.
2. Stores and retrieves appropriate information from the queue database to print or execute the job.
3. Places the job in the appropriate queue to await its turn for processing:
   1. Print jobs are sent to an independent process, called a symbiont, for formatting and are then sent to the printer for printing.
   2. For batch jobs, the job controller creates a batch job process.

One or more queue manager processes control queuing for all processes on a node or in an OpenVMS Cluster environment. Jobs can be submitted from one node and executed on a queue running on another cluster node. User processes, symbionts, and job controllers on each node communicate directly with queue managers.

In addition, the job controller works with the queue manager to perform the following queue management tasks:

• Create and monitor batch, symbiont, and queue manager processes
• Restart the queue manager process on reboot
• Handle failover of the queue manager in an OpenVMS Cluster environment

Queue Manager Failover

By default, in an OpenVMS Cluster environment, the queue manager tries to fail over to another node if the node on which the queue manager is running leaves the cluster.

You can specify the order in which OpenVMS Cluster nodes claim the queue manager process; you can also limit the nodes that can run the queue manager. For more information, see Section 13.6.

Multiple Queue Managers

To work around CPU, disk space, or memory limitations, you can use multiple queue managers to distribute the batch and print work load among nodes as well as to distribute the database files among disks.

For example, you might create separate queue managers for batch queues and print queues. Run the batch queue manager on one node and the print queue manager on a different node. You can also maintain queue and journal files on separate disks.

For information about creating additional queue managers, including reasons and restrictions for using multiple queue managers, see Section 13.8.

13.2 Understanding the Queue Database

The queue database contains files that store information used to keep the queuing system operating, including information about jobs, queues, and the queue manager. The queue database for the default queue manager, SYS$QUEUE_MANAGER, is made up of the following files:

File	Description
Master file, QMAN$MASTER.DAT	Contains: The location of the queue and journal files Definitions of forms and characteristics A list of queue names A list of nodes allowed to run the queue manager A list of queue managers and a list of nodes allowed to run the queue managers
Queue file, SYS$QUEUE_MANAGER.QMAN$QUEUES	Contains the queue definitions formed when you create, start, or modify queues.
Journal file, SYS$QUEUE_MANAGER.QMAN$JOURNAL	Contains information allowing the queue manager to return to the last known state if: A standalone machine stops unexpectedly An OpenVMS Cluster node that is running the queue manager leaves the OpenVMS Cluster environment The journal file also contains job definitions.

On systems with multiple queue managers, the queue database contains an additional queue file and journal file for each additional queue manager. Additional queue files are named in the format name_of_manager.QMAN$QUEUES. Additional journal files are named in the format name_of_manager.QMAN$JOURNAL.

Figure 13-2 shows a queue database containing a master file that lists two queue managers, PRINT_MANAGER and BATCH_MANAGER. Each queue manager has its own queue and journal files.

Figure 13-2 Queue Database

SYS$COMMON:[SYSEXE] is the default location for all queue database files. However, you can store the files in another location. The next section explains why and how to do this.

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.
   In an OpenVMS Cluster environment, enter this command on every node in the cluster.

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

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 Section 5.2.5.

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

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.

13.4 Displaying Information About Queue Managers

To obtain information about one or more queue managers, enter the SHOW QUEUE/MANAGERS command.

Examples

1. The following example displays default (/BRIEF) information about two queue managers, PRINT_MANAGER and SYS$QUEUE_MANAGER.

   $ SHOW QUEUE/MANAGERS Queue manager PRINT_MANAGER, running, on NODEA:: Queue manager SYS$QUEUE_MANAGER, running, on NODED::

2. Use the /FULL qualifier to display complete information about queue managers on the system or cluster.
   In the following example, the master file is in one location, while the queue and journal files belonging to two queue managers are in a different location.

   $ SHOW QUEUE/MANAGERS/FULL Master file: SYS$SPECIFIC:[SYSEXE]QMAN$MASTER.DAT; Queue manager PRINT_MANAGER, running, on NODEA:: /ON=(NODEA,NODEB,*) Database location: DUA2:[SYSQUE] Queue manager BATCH_MANAGER, running, on NODED:: /ON=(NODEC,NODED,NODEE,*) Database location: SYS$SYSROOT:[SYSEXE]

Figure 13-3 shows the locations of the queue database files shown in the second example.

Figure 13-3 Locations of Queue Database Files

Before you can create queues, you must create a queue database by entering a command in the following format:

START/QUEUE/MANAGER/NEW_VERSION[/ON=(node,...)] [dirspec]

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

You normally perform this task only once because when you enter the command, the system stores it, along with any qualifier or parameter you enter, in the queue database.

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.

How to Perform This Task

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 Section 13.11.5.1.
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 Section 13.3.1 or Section 13.3.2, 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 Section 13.11.1 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]

For information about creating one or more additional queue managers, see Section 13.8.

13.6 Customizing Queue Manager Failover

By default, all nodes in an OpenVMS Cluster environment are able to run the queue manager, in no specified order of preference. The /ON qualifier of the START/QUEUE/MANAGER command lets you specify a list of OpenVMS Cluster member nodes in the order that they should claim the queue manager process. Compaq recommends that you specify an asterisk (*) at the end of the node list to make sure that at least one node is always available to run the queue manager.

13.7 Stopping and Restarting the Queue Manager

To stop and restart the queue manager, you need to enter DCL commands.

13.7.1 Stopping the Queue Manager

To shut down the queue manager on a standalone node or an OpenVMS Cluster node, enter the following command:

$ STOP/QUEUE/MANAGER/CLUSTER

The queue manager performs the following tasks:

• Aborts all current jobs that cannot be restarted and requeues all current restartable jobs
• Stops all execution queues
• Disables autostart on all nodes
• Closes all queue database files associated with that queue manager

Once you enter STOP/QUEUE/MANAGER/CLUSTER, the queue manager process remains stopped; requests to that queue manager are denied until you restart the queue manager by entering START/QUEUE/MANAGER. (Note that the queue system remains running as long as one or more queue managers are running.)

OpenVMS Cluster transitions do not change the state of the queue manager. Newly available nodes do not attempt to start the queue manager (unless you enter START/QUEUE/MANAGER).

Use the /CLUSTER qualifier to stop a clusterwide queue manager. If you enter the obsolete command STOP/QUEUE/MANAGER (without the /CLUSTER qualifier), the command performs the same function as STOP/QUEUES/ON_NODE. (Use STOP/QUEUES/ON_NODE to stop all queues on a single node without stopping the queue manager.)

	privacy and legal statement
6017PRO_054.HTML