HP OpenVMS DCL Dictionary
HP OpenVMS DCL Dictionary
STOP/NETWORK
Stops the specified network service on the local node. The /NETWORK
qualifier is required.
Format
STOP/NETWORK network-service
Parameter
network-service
Specifies the name of the network service that you want to halt.
Description
The STOP/NETWORK command causes the specified network to stop executing
on the local node.
Use the START/NETWORK command to release the network from the paused
state.
Example
The STOP/NETWORK command in this example stops the current network
service.
STOP/QUEUE
The STOP/QUEUE command causes the specified execution queue to pause.
All jobs currently executing in the queue are suspended (until the
queue is restarted with the START/QUEUE command), and no new jobs are
initiated. The /QUEUE qualifier is required.
Requires manage (M) access to the queue.
Format
STOP/QUEUE queue-name[:]
Parameter
queue-name[:]
Specifies the name of the queue that you want to pause.
Description
The STOP/QUEUE command causes the specified queue to pause. All jobs
currently executing in the queue are suspended. No new jobs are
initiated.
Use the START/QUEUE command to release the queue from the paused state.
When you restart the queue, any jobs that were executing resume
executing at the point where they left off, unless you use the
/BACKWARD, the /FORWARD, the /SEARCH, or the /TOP_OF_FILE qualifier to
restart a print job at a different place.
For information about how to stop a queue, see the following commands:
STOP/QUEUE/ABORT
STOP/QUEUE/ENTRY
STOP/QUEUE/MANAGER/CLUSTER
STOP/QUEUE/NEXT
STOP/QUEUE/REQUEUE
STOP/QUEUE/RESET
STOP/QUEUES/ON_NODE
Examples
The STOP/QUEUE command in this example suspends the current print job
in the queue LPA0 and places that queue in the paused state.
| #2 |
$ STOP/QUEUE JADE_PRINT
$ START/QUEUE/TOP_OF_FILE JADE_PRINT
|
The STOP/QUEUE command in this example suspends the job that is
currently printing on the printer queue JADE_PRINT and places that
queue in the paused state. The START/QUEUE command releases the queue
from the paused state. The /TOP_OF_FILE qualifier causes the job that
was suspended to resume printing at the beginning of the file rather
than at where it was interrupted.
STOP/QUEUE/ABORT
Aborts a job that is printing or processing on an output queue, deletes
it from the queue, and begins processing the first pending job in the
queue. The /QUEUE qualifier is optional, but the /ABORT qualifier is
required.
Requires delete (D) access to the current job.
Format
STOP/QUEUE/ABORT queue-name[:]
Parameter
queue-name[:]
Specifies the name of the queue containing the job you want to abort.
Description
When you abort a print job, the print job completes the page that is
currently printing. Then the job is removed from the queue. If the
output queue has been set up to put trailing pages at the end of jobs,
a trailer page is printed after the current page is completed. For
information on how a batch job is aborted, see the description of the
STOP/QUEUE/ENTRY command.
Use the STOP/QUEUE/ABORT command to abort the current print job and to
delete it from the queue. You do not specify a job entry number with
the /ABORT qualifier, because output queues can have only one current
job at a time.
Use the STOP/QUEUE/ENTRY command to abort one or more batch jobs that
are executing currently on a queue and to delete them from the queue.
To stop a batch job, you must specify an entry number because batch
queues, unlike print queues, can have more than one job executing at
the same time. (You also can use the STOP/QUEUE/ENTRY command to abort
a print job that is printing or processing currently on a queue, and to
delete it from the queue.)
Use the STOP/QUEUE/REQUEUE command to stop batch or print jobs and to
requeue them. Use the DELETE/ENTRY command to delete an entry that is
queued and awaiting execution.
Note
If you enter the STOP/QUEUE/ABORT command accidentally for a
malfunctioning queue, enter the STOP/QUEUE/RESET command to stop the
queue in an orderly fashion.
|
Example
This example aborts the current print job on the queue LPA0. The print
symbiont begins to process the first pending job in the queue. Assuming
there is no problem with the printer, the current page of the file
completes printing. If the printer queue has been set up to put trailer
pages at the end of jobs, a trailer page is printed after the current
page is completed.
For batch queues an entry number must be provided. To abort a batch
job, use the STOP/QUEUE/ENTRY command.
STOP/QUEUE/ENTRY
Aborts one or more jobs that are executing on a batch queue or printing
on an output queue, deletes them from the queue, and begins processing
the first pending job in the queue. The /QUEUE qualifier is optional,
but the /ENTRY qualifier is required.
Requires delete (D) access to the specified job.
Format
STOP/QUEUE/ENTRY =(entry-number[,...]) [queue-name[:]]
Parameters
entry-number[,...]
Specifies the entry number (or a list of entry numbers) of jobs to be
deleted. If you specify only one entry number, you can omit the
parentheses. If you do not specify a queue name, you can delete entries
from multiple queues.
The system assigns a unique entry number to each queued print or batch
job in the system. By default, the PRINT and SUBMIT commands display
the entry number when they successfully queue a job for processing.
These commands also create or update the local symbol $ENTRY to reflect
the entry number of the most recently queued job. To find a job's entry
number, enter the SHOW ENTRY or the SHOW QUEUE command.
queue-name[:]
Specifies the name of the queue that contains the jobs that you want to
abort. The queue name can refer either to the queue to which the job
was submitted or to the queue where the job is executing. The
queue-name parameter is optional syntax; however, when you
specify a queue name, the OpenVMS system uses it to verify an entry in
the specific queue before stopping and deleting the entry.
Description
When you abort a batch job, the system tries to stop the job in an
orderly fashion by closing any open files and sending a message to the
log file. For information on how a print job is aborted, see the
description of the STOP/QUEUE/ABORT command.
Use the STOP/QUEUE/ENTRY command to abort one or more batch jobs that
are executing currently on a queue and to delete them from the queue.
To stop a batch job, you must specify an entry number because batch
queues, unlike print queues, can have more than one job executing at
the same time. (You also can use the STOP/QUEUE/ENTRY command to abort
a print job that is currently printing or processing on a queue and to
delete it from the queue.)
Use the STOP/QUEUE/REQUEUE command to stop batch or print jobs and to
requeue them. Use the DELETE/ENTRY command to delete an entry that is
queued and is awaiting execution.
Note
If you enter the STOP/QUEUE/ENTRY command accidentally for a
malfunctioning queue, enter the STOP/QUEUE/RESET command to stop the
queue in an orderly fashion.
|
Example
|
$ STOP/QUEUE/ENTRY=365 SYS$BATCH
|
The STOP/QUEUE/ENTRY command in this example aborts batch job number
365 currently executing on the SYS$BATCH queue and begins the first
pending job in the queue.
STOP/QUEUE/MANAGER/CLUSTER
Shuts down the queue manager on a standalone node or an OpenVMS
Cluster. The /QUEUE qualifier is optional, but the /MANAGER and
/CLUSTER qualifiers are required on both standalone and clustered
systems. By default, the command affects the default queue manager,
SYS$QUEUE_MANAGER. Specify the /NAME_OF_MANAGER qualifier to shut down
a queue manager other than the default.
Requires OPER (operator) and SYSNAM (system logical name)
privileges.
Format
STOP/QUEUE/MANAGER/CLUSTER
Parameters
None.
Description
The STOP/QUEUE/MANAGER/CLUSTER command notifies the queue manager to
perform the following on the standalone node or on all nodes in the
cluster:
- Abort all of the current jobs that cannot be restarted, and requeue
all of the current restartable jobs on the queue manager
- Stop all of the execution queues on the queue manager
- Disable the autostart feature for all of the queue manager's
autostart queues
- Close the queue manager's queue and journal files
Once the STOP/QUEUE/MANAGER/CLUSTER command is entered, the affected
queue manager process remains stopped, and requests to the queuing
system are denied until the DCL command START/QUEUE/MANAGER is entered.
Qualifier
/NAME_OF_MANAGER=name
Specifies the name of the queue manager process to be stopped. If the
/NAME_OF_MANAGER qualifier is omitted, the default queue manager name
SYS$QUEUE_MANAGER is used. For more information, refer to the chapter
about the queue manager in the HP OpenVMS System Manager's Manual.
Example
|
$ STOP/QUEUE/MANAGER/CLUSTER
|
The STOP/QUEUE/MANAGER/CLUSTER command in this example stops the queue
manager process, SYS$QUEUE_MANAGER. The process remains stopped and
requests to SYS$QUEUE_MANAGER will be denied until the
START/QUEUE/MANAGER command is entered.
This command stops the default queue manager SYS$QUEUE_MANAGER because
the /NAME_OF_MANAGER qualifier is not specified.
STOP/QUEUE/NEXT
Stops the specified queue after all executing jobs have completed
processing. No new jobs are initiated.
The /QUEUE qualifier is optional, but you must specify the /NEXT
qualifier.
Requires manage (M) access to the queue.
Format
STOP/QUEUE/NEXT queue-name[:]
Parameter
queue-name[:]
Specifies the name of the queue that you want to stop.
Description
The STOP/QUEUE/NEXT command stops the queue after it allows any current
jobs to complete execution. No new jobs are initiated.
You should use the STOP/QUEUE/NEXT command before deassigning,
deleting, or merging a queue, as this command allows all currently
executing jobs to complete processing before changes are made to the
queue. You might also use this command to stop a queue if you need to
perform planned service on a printing device. Use the START/QUEUE
command to restart the queue.
For autostart queues, the STOP/QUEUE/NEXT command stops the queue and
makes it inactive for autostart, so it will not be automatically
started. For this reason, you might use this command to prevent an
autostart queue from being accidentally restarted when a printing
device needs to undergo planned service. Use the START/QUEUE command to
reactivate the queue for autostart.
Examples
| #1 |
$ STOP/QUEUE/NEXT LASER_PRINT
|
In this example, the STOP/QUEUE/NEXT command prepares to stop the queue
LASER_PRINT. The currently printing job is allowed to complete, but no
new job is allowed to initiate. Once the current job has finished, the
queue is stopped.
If LASER_PRINT is an autostart queue, it will not be automatically
started until you enter the START/QUEUE command.
| #2 |
$ STOP/QUEUE/NEXT BATCH_1
$ SHOW QUEUE/ALL BATCH_1
Batch queue BATCH_1, stopped, on JADE::
$ DELETE/QUEUE BATCH_1
|
This example shows how to delete the batch queue BATCH_1. First, the
STOP/QUEUE/NEXT command is entered, which stops the queue after jobs
currently executing on the queue are completed. Second, the SHOW
QUEUE/ALL command is entered to ensure that no jobs are pending in the
queue. The screen display shows that no jobs are pending. Finally, the
DELETE/QUEUE command is entered to delete the queue BATCH_1.
STOP/QUEUE/REQUEUE
Stops the current jobs on the specified queue and requeues them for
later processing. The queue does not stop; processing of the first
pending job in the queue begins. The /QUEUE qualifier is optional, but
the /REQUEUE qualifier is required. The /ENTRY qualifier is required to
requeue batch jobs.
Requires delete (D) access to the current or specified
job.
Format
STOP/QUEUE/REQUEUE [=queue-name] queue-name[:]
STOP/QUEUE/REQUEUE [=queue-name] /ENTRY=(entry-number[,...])
queue-name[:]
Parameters
queue-name[:]
Specifies the name of the queue that contains the jobs that you want to
stop. When you specify a queue name as a parameter for the /REQUEUE
qualifier, the jobs are requeued to that queue; otherwise, the jobs are
requeued in the current queue.
entry-number[,...]
Specifies the entry number (or a list of entry numbers) of the jobs you
want to requeue. If you specify only one entry number, you can omit the
parentheses.
The system assigns a unique entry number to each queued print or batch
job in the system. By default, the PRINT and SUBMIT commands display
the entry number when they successfully queue a job for processing.
These commands also create or update the local symbol $ENTRY to reflect
the entry number of the most recently queued job. To find a job's entry
number, enter the SHOW ENTRY or SHOW QUEUE command.
Description
The STOP/QUEUE/REQUEUE command causes the system to requeue the jobs
for later processing or for execution in the queue. If the print
symbiont has sent checkpoint information about a print job to the job
controller, printing resumes at the last checkpoint recorded, unless
you enter the SET ENTRY/NOCHECKPOINT command before the job is
reinitiated. Batch jobs generally restart at the beginning; however,
batch jobs that contain SET RESTART_VALUE commands run only those
portions of the job that have not completed successfully.
Use the STOP/QUEUE/ABORT command to stop a current print job without
requeueing it. Use the STOP/QUEUE/ENTRY command to stop a current batch
job without requeueing it. You also can use the STOP/QUEUE/ENTRY
command to stop a print job without requeueing it. Use the DELETE/ENTRY
command to delete an entry that is queued and is waiting to be executed
or processed.
Note
If you enter the STOP/QUEUE/REQUEUE command accidentally for a
malfunctioning queue, enter the STOP/QUEUE/RESET command to stop the
queue in an orderly fashion.
|
Qualifiers
/ENTRY=(entry-number[,...])
Specifies the entry number of one or more jobs you want to abort. If
you specify only one entry number, you can omit the parentheses.
The system assigns a unique entry number to each queued print or batch
job in the system. By default, the PRINT and SUBMIT commands display
the entry number when they successfully queue a job for processing.
These commands also create or update the local symbol $ENTRY to reflect
the entry number of the most recently queued job. To find a job's entry
number, enter the SHOW ENTRY or the SHOW QUEUE command.
You must use the /ENTRY qualifier when you enter the STOP/QUEUE/REQUEUE
command for a batch queue. Entry numbers specified must match entry
numbers of executing jobs.
/HOLD
Places the aborted job or jobs in a hold state for later release with
the SET ENTRY/RELEASE or SET ENTRY/NOHOLD command.
/PRIORITY=n
Requires OPER (operator) or ALTPRI (alter privilege) privilege
to raise the priority value above the value of the system parameter
MAXQUEPRI.
Changes the priority of the requeued job or jobs. The parameter
n can be from 0 to 255; the default value of the n
parameter is the same as the priority value that the job or jobs had
when they were stopped.
Generally, the /PRIORITY qualifier is used to lower the priority of a
job or jobs, which ensures that the job or jobs runs when the queue
contains no other jobs. No privilege is needed to set the priority
lower than the MAXQUEPRI value.
/REQUEUE=[queue-name]
Specifies a queue where current jobs are to be requeued. If you do not
specify the queue-name parameter, the jobs are requeued in the
current queue.
Examples
| #1 |
$ STOP/QUEUE/REQUEUE=LPB0 LPA0
|
In this example, the current print job on queue LPA0 is stopped and
requeued to queue LPB0. If the print symbiont sent checkpoint
information about the print job to the job controller, printing resumes
on LPB0 at the last checkpoint recorded.
| #2 |
$ STOP/QUEUE/REQUEUE/HOLD LPA0
.
.
.
$ SET ENTRY 254/RELEASE
|
In this example, the current print job on LPA0 is suspended and placed
in the hold state. Later, when you enter the SET ENTRY command with the
/RELEASE qualifier, the job is released from the hold state and is
rescheduled to print on queue LPA0. If the print symbiont sent
checkpoint information about the print job to the job controller,
printing resumes at the last checkpoint.
| #3 |
$ STOP/QUEUE/REQUEUE/ENTRY=758 SYS$BATCH
|
In this example, batch job number 758 is stopped and requeued for later
processing on SYS$BATCH. If the batch job has been programmed with
appropriate SET RESTART_VALUE commands, those portions of the job that
have completed successfully are not rerun.
STOP/QUEUE/RESET
Abruptly stops the queue and returns control to the system. Any jobs
that cannot be restarted are aborted immediately.
The /QUEUE qualifier is optional, but you must specify the /RESET
qualifier.
Requires manage (M) access to the queue.
Format
STOP/QUEUE/RESET queue-name[:]
Parameter
queue-name[:]
Specifies the name of the queue you want to reset.
Description
The STOP/QUEUE/RESET command stops the queue as soon as the system
receives the command. The queue manager requests termination for all
executing jobs, but aborts or requeues executing jobs without waiting
for termination status to be received. Current jobs that can be
restarted are requeued for processing. Current jobs that cannot be
restarted are aborted and must be resubmitted for processing. (Print
jobs are restartable by default. Batch jobs are restartable if
submitted with the SUBMIT/RESTART command.)
Use the START/QUEUE command to restart the queue.
For autostart queues, the STOP/QUEUE/RESET command stops the queue and
makes it inactive for autostart, so it will not be automatically
started. For this reason, you might use this command to prevent an
autostart queue from being automatically restarted when a printing
device fails and needs to be serviced. Use the START/QUEUE command to
reactivate the queue for autostart.
Examples
| #1 |
$ INITIALIZE/QUEUE/AUTOSTART_ON=MYNODE::LPAO/START LPA0
$ENABLE AUTOSTART/QUEUES/ON_NODE=MYNODE
.
.
.
$STOP/QUEUE/RESET LPA0
$START/QUEUE LPA0
|
THE INITIALIZE/QUEUE command in this example creates an autostart
output queue named LPA0. The /START qualifier activates the queue for
autostart, and the ENABLE AUTOSTART/QUEUES command causes the queue to
begin executing.
Suppose the printer LPA0:: runs out of paper. The STOP/QUEUE/RESET
command abruptly stops the queue LPA0. The current print job stops
immediately and is requeued. The STOP/QUEUE/RESET command also makes
the queue inactive for autostart, so it will not be restarted while the
printer's paper is being resupplied.
After the printer is loaded with paper, the START/QUEUE command makes
the queue active for autostart and allows the queue manager to
automatically start it again.
| #2 |
$ STOP/QUEUE/RESET TEXBATCH
|
The STOP/QUEUE/RESET command in this example stops the batch queue
TEXBATCH. Any current jobs that were submitted with the /RESTART
qualifier are requeued for processing when the queue is restarted.
Users might want to resubmit current jobs that were not originally
submitted with the /RESTART qualifier.
|
