Updated: 11 December 1998 |
OpenVMS System Manager's Manual
Previous | Contents | Index |
Create queues in the following order:
For detailed instructions on creating and starting queues, see the following sections:
Task | For More Information |
---|---|
Autostart execution queues | Section 13.4.1 |
Nonautostart execution queues | Section 13.4.2 |
Generic queues | Section 13.4.3 |
To create and start an autostart execution queue, complete these tasks:
$ 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) |
The commands in this example perform the following tasks:
Detailed explanations of each task follow.
13.4.1.1 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:
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. |
How to Specify a Failover List
As the table indicates, to specify a failover list:
You must activate an autostart queue in one of the following ways:
INITIALIZE/QUEUE/START/AUTOSTART_ON[/qualifiers,...] queue-name |
START/QUEUE[/qualifiers,...] queue-name |
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:
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:
$ ENABLE AUTOSTART/QUEUES |
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 Section 13.4.1.2. |
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.
13.4.1.4 Adding Commands to Your Startup Procedure
Compaq 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 |
For more examples, see the SYS$MANAGER:SYSTARTUP_VMS.COM template on
your system disk.
13.4.2 Creating and Starting Nonautostart Execution Queues
This section describes how to create and start a nonautostart queue.
The following example creates a batch queue named SYS$BATCH and starts the queue on LILITH:
$ INITIALIZE/QUEUE/START/BATCH/ON=LILITH::SYS$BATCH |
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. |
You must start a nonautostart queue in one of the following ways:
INITIALIZE/QUEUE/START/ON[/qualifiers,...] queue-name |
START/QUEUE[/qualifiers,...] queue-name |
For each nonautostart queue, you must include a START/QUEUE command
naming the queue in your startup command procedure.
This section describes how to create and start a generic queue.
13.4.3.1 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.
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 |
You must start a generic queue in one of the following ways:
INITIALIZE/QUEUE/START/GENERIC(=queue-name[,...])[/qualifiers, ...] queue-name |
START/QUEUE[/qualifiers,...] queue-name |
Information about forms, characteristics, and queues is stored in the queue database. For this reason, creating forms, queues, and characteristics each time the node or OpenVMS Cluster system reboots is unnecessary. However, you must start nonautostart execution queues and enable autostart each time a node reboots. To do so, create a command procedure.
If your configuration is simple, you can add the commands to the site-specific startup command procedure SYSTARTUP_VMS.COM. If your configuration requires a large number of commands, create a separate command procedure and execute it from SYSTARTUP_VMS.COM.
Generic queues are not automatically stopped when a node shuts down.
Therefore, including commands to start generic queues in your startup
command procedure is unnecessary.
13.6 Using Queue Options
The following table describes options that you can use with queues:
Options | Type of queue | Reference |
---|---|---|
Control of access to queues | Batch and output | Section 13.6.1 |
Job retention | Batch and output | Section 13.6.2 |
Characteristics | Batch and output | Section 13.6.3 |
Control of batch processing | Batch | Section 13.6.4 |
Control of job scheduling | Output | Section 13.6.5 |
Banner pages | Output | Section 13.6.6 |
Forms | Output | Section 13.6.7 |
Control of line and page overflow | Output | Section 13.6.7.8 |
Suppression of initial form feed | Output | Section 13.6.7.9 |
Device control library modules | Output | Section 13.6.8 |
You can implement options in either of the following ways:
Table 13-1 lists qualifiers you can use to specify queue options, and indicates the type of queue for which you can specify each option.
Qualifier | Type of Queue | Description | For More Information |
---|---|---|---|
/AUTOSTART_ON | Batch and output | Creates an autostart execution queue and specifies the node or nodes (and for output queues, the device or devices) on which the queues can run. | Section 13.4.1 |
/BASE_PRIORITY | Batch and output | Specifies a base process priority (not the same as the job scheduling priority). For a batch queue, specifies the base priority for processes executing jobs in the queue. For output queues, specifies the base priority of the symbiont process. | Section 13.6.4.1 |
/BLOCK_LIMIT | Output | Limits the size of print jobs that can be processed on an output execution queue. | Section 13.6.5.1 |
/CHARACTERISTIC
/CHARACTERISTICS |
Batch and output | Specifies one or more characteristics associated with the queue. | Section 13.6.3 |
/CPUDEFAULT | Batch | Defines the default CPU time limit for batch jobs executed in the queue. | Section 13.6.4 |
/CPUMAXIMUM | Batch | Defines a maximum CPU time limit for batch jobs executed in the queue. | Section 13.6.4 |
/DEFAULT | Output | Establishes defaults for certain options of the PRINT command. After you set an option for the queue with the /DEFAULT qualifier, users do not have to specify that option in their PRINT commands. However, they can specify options to override the defaults set on the queues. Possible default options are as follows: | |
BURST | Section 13.6.6 | ||
FEED | Section 13.6.7.8 | ||
FLAG | Section 13.6.6 | ||
FORM | Section 13.6.7 | ||
TRAILER | Section 13.6.6 | ||
/DESCRIPTION | Batch and output | Specifies a text string to provide users with information about the queue. | |
/DEVICE | Output |
Specifies the type of output execution queue. The keywords are as
follows:
PRINTER (default) TERMINAL SERVER
|
Section 13.7.1.1 |
/DISABLE_SWAPPING | Batch | Specifies whether batch jobs executed from a queue can be swapped in and out of memory. | Section 13.6.4 |
/FORM_MOUNTED | Output | Specifies the mounted form for an output execution queue. | Section 13.6.7 |
/GENERIC | Batch and output | Creates a generic queue and names the execution queues it feeds. | Section 13.4.3.1 |
/JOB_LIMIT | Batch | Indicates the number of batch jobs that can be executed concurrently from a batch queue. | Section 13.6.4 |
/LIBRARY | Output | Specifies the file name for a device control library. | Section 13.6.8 |
/NAME_OF_MANAGER | Batch and output | Specifies the name of the queue manager with which the queue will be associated. | Section 12.8 |
/NO_INITIAL_FF | Output | Specifies the qualifier for an output execution queue; suppresses the initial form feed sent to an output execution queue. | Section 13.6.7.9 |
/ON | Batch and output | Creates a nonautostart execution queue and specifies the node (and, for output queues, the device) on which the queue is to run. | Section 13.4.2.1 |
/OWNER_UIC | Batch and output | Specifies the user identification code (UIC) for the queue. | Section 13.6.1.2 |
/PROCESSOR | Output | Specifies the symbiont to be used with an output execution queue. The default is the standard operating system print symbiont PRTSMB. | Section 13.4.1 |
/PROTECTION | Batch and output | Specifies a protection for the queue. | Section 13.6.1.2 |
/RECORD_BLOCKING | Output | Determines whether the symbiont can concatenate (or block together) output records for transmission to the output device. | Section 13.4.1 |
/RETAIN | Batch and output | Holds jobs in the queue after they have executed. | Section 13.6.2 |
/SCHEDULE | Output | Specifies whether pending jobs in a queue are scheduled based on the size of the job. | Section 13.6.5 |
/SEPARATE | Output | Specifies required job separation or job reset options for an output execution queue. Required options cannot be overridden by the PRINT command. Possible options are as follows: | |
BURST | Section 13.6.6 | ||
FLAG | Section 13.6.6 | ||
RESET | Section 13.6.8 | ||
TRAILER | Section 13.6.6 | ||
/WSDEFAULT | Batch and output |
For batch queues, specifies a default working set size for batch jobs
executed in the queue. For output queues, specifies a default working
set size for the symbiont process.
The value set by this qualifier overrides the value defined in the UAF of any user submitting a job to the queue. |
Section 13.6.4 |
/WSEXTENT | Batch and output |
For batch queues, specifies the working set extent for batch jobs
executed in the queue. For output queues, specifies a working set
extent for the symbiont process.
The value set by this qualifier overrides the value defined in the UAF of any user submitting a job to the queue. |
Section 13.6.4 |
/WSQUOTA | Batch and output |
For batch queues, specifies the working set quota for batch jobs
executed in the queue. For output queues, specifies a working set quota
for the symbiont process.
The value set by this qualifier overrides the value defined in the UAF of any user submitting a job to the queue. |
Section 13.6.4 |
Previous | Next | Contents | Index |
Copyright © Compaq Computer Corporation 1998. All rights reserved. Legal |
6017PRO_057.HTML
|