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

Setting Up and Maintaining Queues

Planning Your Queue Setup

Restarting Execution Queues on Reboot

Creating and Starting Queues  

1. Execution queues
2. Generic queues

For detailed instructions on creating and starting queues, see the following sections:

Task	For More Information
Autostart execution queues	Creating and Starting Autostart Execution Queues
Nonautostart execution queues	Creating and Starting Nonautostart Execution Queues
Generic queues	Creating and Starting Generic Queues

Creating and Starting Autostart Execution Queues  

To create and start an autostart execution queue, complete these tasks:

1. Create the queue as an autostart queue and, optionally, specify a failover list.
2. Activate the queue for autostart. You can do this either when you create a queue, or after you create one.
3. Enable autostart on a node. You can do this before or after you create a queue.

Example

$ INITIALIZE/QUEUE/START/DEFAULT=(NOBURST,FLAG=ALL,TRAILER=ONE) -
_$ /AUTOSTART_ON=(LILITH::LPA0:,SMITTN::LPA0:)  LPA0 [1] 
 
$ INITIALIZE/QUEUE/START/DEVICE=TERMINAL/ -
_$ /AUTOSTART_ON=(LILITH::LTA3331:,SMITTN::LTA555:) -
_$ /RECORD_BLOCKING/BLOCK_LIMIT=600/CHARACTERISTICS=(EAST)-
_$ /SEPARATE=(NOBURST,NOTRAILER,NOFLAG,RESET=ANSI$RESET) -
_$ /DEFAULT=(NOFEED,NOBURST,FLAG=ONE,NOTRAILER,FORM=MEMO) -
_$ /LIBRARY=LN03LIBRARY /PROCESSOR=LATSYM      LN03_1 [2] 
 
$ ENABLE AUTOSTART/QUEUES [3] 
$ ENABLE AUTOSTART/QUEUES/ON_NODE=SMITTN [4] 

1. Creates an autostart queue named LPA0 and activates it for autostart. Because this is an autostart queue with a failover list, this queue can run on either LILITH::LPA0 or SMITTN::LPA0.
2. Creates an autostart queue named LN03_1 for LAT printers and activates it for autostart. Because this is an autostart queue with a failover list, this queue can run on either of the printers attached to LAT ports LTA3331: on node LILITH or LTA555: on node SMITTN.
3. Enables autostart on the node on which the process is running. Assume this is node LILITH. Because both LPA0 and LN03_1 are active autostart queues capable of running on node LILITH, these queues will start up on this node.
4. Enables autostart on node SMITTN. If LILITH becomes unavailable, both LPA0 and LN03_1 can fail over to node SMITTN.

Detailed explanations of each task follow.

Creating an Autostart Queue  

To create an autostart execution queue, use the /AUTOSTART_ON qualifier with the INITIALIZE/QUEUE command, as shown in the following table:

Type of Queue	Command
Output queues	INITIALIZE/QUEUE/AUTOSTART_ON=(node::[device:] [,...]) queue-name For node::, specify the name of the node on which the queue is to run. For device:, specify the name of the output device to which the queue's output is sent. To allow the autostart queue to fail over to another node and device, specify a list of nodes and devices, separated by commas.
Batch queues	INITIALIZE/QUEUE/BATCH/AUTOSTART_ON=(node:: [,...]) queue-name The /BATCH qualifier creates a batch queue. For node::, specify the name of the node on which the queue is to run. To allow the autostart queue to fail over to another node, specify a list of nodes, separated by commas.

The system does not check the node name you specify as node:: to determine if it is an existing node name, so be sure to specify the node name correctly.

As the table indicates, to specify a failover list:

• For output queues, replace device with a list of failover devices.



• For batch queues, replace node with a list of failover nodes.

Activating an Autostart Queue  

You must activate an autostart queue in one of the following ways:

• Use the /START qualifier in the INITIALIZE/QUEUE command used to create the queue, as follows:INITIALIZE/QUEUE/START/AUTOSTART_ON[/qualifiers,...] queue-name



• Enter START/QUEUE after you create the queue, as follows:START/QUEUE[/qualifiers,...] queue-name

Once an autostart queue is activated, it remains active until the queue is stopped with STOP/QUEUE/NEXT or STOP/QUEUE/RESET. Shutting down a node does not deactivate autostart queues on the node.

How to Start a Deactivated Queue

To start an autostart queue that has been deactivated by STOP/QUEUE/NEXT or STOP/QUEUE/RESET, enter START/QUEUE. The queue is then automatically started by the queue manager either:

• Immediately if a node on which the queue can run is enabled for autostart



• As soon as a node on which the queue can run is enabled for autostart

Enabling an Autostart Queue  

You must enable autostart on a node to start autostart queues. You can do this either before or after you create an autostart queue. Perform the following steps to enable autostart:

1. For each node on which you want autostart queues to run (including those to which the queues can later fail over), enter the following command:

   $ ENABLE AUTOSTART/QUEUES

   Enabling autostart on a node notifies the queue manager to automatically perform the following tasks:
   • Start all active and valid autostart queues on the node
   
   
   
   • Start any active autostart queue that fails over to the node
   By default, the command affects the node from which it is entered. Specify the /ON_NODE qualifier to enable autostart on a different node.

   ---

   The ENABLE AUTOSTART/QUEUES command starts only valid, active autostart queues capable of running on a node. If an autostart queue does not start when you enter this command, the queue might not be active for autostart. You must activate autostart queues, as explained in Activating an Autostart Queue).

   ---

2. Add the ENABLE AUTOSTART/QUEUES command to your startup command procedure on each node that is to run autostart queues to ensure that autostart is enabled each time the node reboots.

How to Start Stopped Autostart Queues

You can start all stopped active autostart queues on a node by enabling autostart for queues with ENABLE AUTOSTART/QUEUES. Including a separate START/QUEUE command to start an active autostart queue is not necessary.

When a node reboots, autostart is disabled until you enter ENABLE AUTOSTART/QUEUES.

Adding Commands to Your Startup Procedure  

HP recommends that you add ENABLE AUTOSTART/QUEUES to your startup procedure on all of your nodes. Add this command following the commands that configure printer devices and mount important disks. Adding the command eliminates the necessity of adding it later, if you need to add autostart queues or add nodes to autostart queue failover lists.

The following example illustrates some sample commands that you might add to a node's SYSTARTUP_VMS.COM procedure:

$! Start the nonautostart batch queue
$ START/QUEUE SYS$BATCH
$! Start all autostart queues
$ ENABLE AUTOSTART/QUEUES

Creating and Starting Nonautostart Execution Queues  

This section describes how to create and start a nonautostart queue.

Example

The following example creates a batch queue named SYS$BATCH and starts the queue on LILITH:

$ INITIALIZE/QUEUE/START/BATCH/ON=LILITH::SYS$BATCH

Creating a Nonautostart Queue  

To create a nonautostart execution queue, use the /ON qualifier with the INITIALIZE/QUEUE command, as shown in the following table:

Type of Queue	Command
Output queues	INITIALIZE/QUEUE/ON=node::device: queue-name For node::, specify the node on which the queue is to execute. For device:, specify the device to which the queue's output is sent.
Batch queues	INITIALIZE/QUEUE/BATCH/ON=node:: queue-name The /BATCH qualifier is required to create a batch queue. For node::, specify the node on which the queue is to execute.

Starting a Nonautostart Queue  

You must start a nonautostart queue in one of the following ways:

• Enter the /START qualifier in the INITIALIZE/QUEUE command that you use to create the queue, with the following format:INITIALIZE/QUEUE/START/ON[/qualifiers,...] queue-name



• Enter START/QUEUE after you create the queue, using the following format:START/QUEUE[/qualifiers,...] queue-nameFor each nonautostart queue, you must include a START/QUEUE command naming the queue in your startup command procedure.

Creating and Starting Generic Queues  

This section describes how to create and start a generic queue.

Creating a Generic Queue  

To create a generic queue, use the /GENERIC qualifier with the INITIALIZE/QUEUE command, as shown in the following table:

Type of Queue	Command
Output queue	INITIALIZE/QUEUE/GENERIC[=(queue-name[,...])] queue-name The /GENERIC qualifier specifies that the queue is a generic queue. For the first queue-name, specify the execution queue to which the generic queue sends jobs. For the second queue-name, specify the generic queue to which output is sent.
Batch queues	INITIALIZE/QUEUE/BATCH/GENERIC[=(queue-name[,...]) queue-name The /BATCH qualifier is required to create a batch queue. For queue-name, specify the execution queue to which the generic queue sends jobs. The execution queue must be a batch queue.

You can also set up a generic queue without explicitly naming the execution queues to which it may send jobs. Instead, use the /ENABLE_GENERIC qualifier with INITIALIZE/QUEUE, START/QUEUE, or SET QUEUE for the execution. This method is not normally recommended. However, if your queue configuration is simple, you can use this method.

Example

The following example creates a generic queue (LN03_PRINT), which lists execution queues to which LN03_PRINT sends jobs:

$ INITIALIZE/QUEUE/GENERIC=(LN03_1,LN03_2,LN03_3) LN03_PRINT

Starting a Generic Queue  

You must start a generic queue in one of the following ways:

• Use the /START qualifier in the INITIALIZE/QUEUE command used to create the queue, using the following format:INITIALIZE/QUEUE/START/GENERIC(=queue-name[,...])[/qualifiers, ...] queue-name



• Enter START/QUEUE after you create the queue, using the following format:START/QUEUE[/qualifiers,...] queue-name

Planning Your Queue Setup

Restarting Execution Queues on Reboot