HP OpenVMS DCL Dictionary
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.
| 
