HP OpenVMS DCL Dictionary
ENABLE AUTOSTART
Enables the autostart feature on a node for all autostart queues
managed by the specified queue manager. By default, this command uses
the /QUEUES qualifier.
Requires OPER (operator) privileges.
For more information on autostart queues, see the chapter on batch and
print queues in the HP OpenVMS System Manager's Manual.
Format
ENABLE AUTOSTART[/QUEUES]
Parameters
None.
Description
Enabling autostart for queues notifies the queue manager to
automatically start all of its stopped active autostart queues on a
node. It also notifies the queue manager to automatically start any of
its autostart queues that fail over to the node. By default, the ENABLE
AUTOSTART command affects the node from which it is entered. Specify
the /ON_NODE qualifier to enable autostart on a different node.
By default, the command affects autostart queues managed by the default
queue manager, SYS$QUEUE_MANAGER. Specify the /NAME_OF_MANAGER
qualifier to disable autostart of a different queue manager's autostart
queues on the node.
An autostart queue is active if it has been activated by the /START
qualifier with the INITIALIZE/QUEUE command or by the START/QUEUE
command and has not been stopped by the STOP/QUEUE/NEXT or
STOP/QUEUE/RESET command.
When a node boots, autostart is disabled until you enter the ENABLE
AUTOSTART command. Typically, you would add this command to your
site-specific startup command procedure or your queue startup command
procedure to start a node's autostart queues each time the node boots.
Qualifiers
/NAME_OF_MANAGER=name
Specifies the name of the queue manager controlling the autostart
queues you want to enable. The qualifier allows the autostart feature
to be used differently for different sets of queues.
If the /NAME_OF_MANAGER qualifier is omitted, the default queue manager
name SYS$QUEUE_MANAGER is used.
For more information on multiple queue managers, see the chapter on the
queue manager in the HP OpenVMS System Manager's Manual.
/ON_NODE=nodename
Specifies a node in an OpenVMS Cluster system. Use this qualifier to
enable autostart on a node other than the one from which you enter the
command.
/QUEUES
Specifies that autostart is to be enabled for queues. (This qualifier
is used by default.)
Examples
#1 |
$ INITIALIZE/QUEUE/BATCH/START-
_$ /AUTOSTART_ON=SATURN:: BATCH_1
$ ENABLE AUTOSTART/QUEUES
.
.
.
$ DISABLE AUTOSTART/QUEUES
|
In this example, the INITIALIZE/QUEUE command creates an autostart
queue BATCH_1, capable of running on node SATURN. The /START qualifier
activates the queue for autostart. The ENABLE/AUTOSTART/QUEUES command
(executed on node SATURN) enables autostart on the node, causing the
queue (and any other active autostart queues on the node) to begin
executing jobs.
The DISABLE AUTOSTART command (executed on node SATURN) stops autostart
queues on the node and prevents any queues from failing over to the
node.
These commands only affect queues managed by the default queue manager
SYS$QUEUE_MANAGER because the /NAME_OF_MANAGER qualifier is not
specified.
Because BATCH_1 is set up to run only on one node, the queue cannot
fail over to another node and therefore is stopped; however, the queue
remains active for autostart and will be started when the ENABLE
AUTOSTART command is entered for node SATURN. No START/QUEUE command is
needed to restart BATCH_1 unless autostart of the queue is deactivated
with the STOP/QUEUE/NEXT or STOP/QUEUE/RESET command.
#2 |
$ INITIALIZE/QUEUE/BATCH/START-
_$ /AUTOSTART_ON=(NEPTUN::,SATURN::) BATCH_1
$ ENABLE AUTOSTART/QUEUES/ON_NODE=NEPTUN
$ ENABLE AUTOSTART/QUEUES/ON_NODE=SATURN
.
.
.
$ STOP/QUEUES/ON_NODE=NEPTUN
|
In this example, the INITIALIZE/QUEUE command creates an autostart
queue BATCH_1. The /START qualifier activates the queue for autostart.
The first ENABLE AUTOSTART/QUEUES command causes the queue to begin
executing on node NEPTUN. The second ENABLE AUTOSTART/QUEUES command
enables autostart on node SATURN to start all stopped active autostart
queues on that node and to start any autostart queues that might fail
over to that node.
Later, suppose node NEPTUN must be removed from the OpenVMS Cluster
system. The STOP/QUEUES/ON_NODE command stops all queues on node
NEPTUN, and causes the autostart queue BATCH_1 to fail over to node
SATURN. Because the queue is active for autostart, and because
autostart has been enabled on node SATURN, the queue is automatically
started on that node.
This command only affects queues managed by the default queue manager
SYS$QUEUE_MANAGER because the /NAME_OF_MANAGER qualifier is not
specified.
|