HELP STOP — VMS 5.4
Terminates execution of a command, an image, a command procedure,
a command procedure that was interrupted by a CTRL/Y function, or
a detached process or subprocess.
Requires GROUP privilege to stop other processes in the same
group. Requires WORLD privilege to stop processes outside your
group.
Format
STOP [process-name]
The STOP command performs entirely different functions when used
with certain qualifiers as follows:
STOP Qualifier(s) Function
/CPU Stops the specified secondary processor
or processors (and any associated vector
processors) in a VMS multiprocessing
system.
/QUEUE Causes the specified execution queue to
pause.
/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.
/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.
/QUEUE/MANAGER Performs an orderly shutdown of the
system job queue manager on the node
from which the command is entered.
/QUEUE/NEXT Stops the specified queue after all
executing jobs have completed processing.
/QUEUE/REQUEUE Stops the current jobs on the specified
queue and requeues them for later
processing.
/QUEUE/RESET Abruptly stops the queue and returns
control to the system.
/ZONE Removes a zone from the VAXft 3000.
Additional information available:
PARAMETER
process-name Requires that the process be in your group. Specifies the name of the process to be deleted. The process name can have from 1 to 15 alphanumeric characters. The specified process must have the same group number in its user identification code (UIC) as the current process; you cannot use the process- name parameter to stop a process outside of your group. To stop a process outside of your group, you must use the qualifier /IDENTIFICATION=pid. The process name cannot be used with the /IDENTIFICATION qualifier; if you use the /IDENTIFICATION qualifier, the process name is ignored. If you include neither the process-name parameter nor the /IDENTIFICATION qualifier with the STOP command, the image executing in the current process is terminated.
QUALIFIER
Additional information available:
/IDENTIFICATION
/IDENTIFICATION=pid
Specifies the system-assigned process identification (PID)
code. When you create a process with the RUN command, the RUN
command displays the PID code of the newly created process. The
/IDENTIFICATION qualifier can be used in place of the process name
parameter.
You can omit any leading zeros in specifying the PID code.
EXAMPLES
1. $ RUN MYPROG
.
.
.
<Ctrl/Y>
Interrupt
$ STOP
The RUN command in this example begins executing the image
MYPROG. Subsequently, the CTRL/Y function interrupts the
execution. The STOP command then terminates the image.
2. $ @TESTALL
.
.
.
<Ctrl/Y>
Interrupt
$ STOP
The @ (execute procedure) command in this example executes
the procedure TESTALL.COM. The CTRL/Y function interrupts the
procedure. The STOP command returns control to the DCL command
interpreter.
3. $ RUN/PROCESS_NAME=LIBRA LIBRA
%RUN-S-PROC_ID, identification of created process is 0013340D
.
.
.
$ STOP LIBRA
The RUN command in this example creates a subprocess named
LIBRA to execute the image LIBRA.EXE. Subsequently, the STOP
command causes the image to exit and deletes the process.
4. $ ON ERROR THEN STOP
.
.
.
In a command procedure, the ON command establishes a default
action when any error occurs in the execution of a command or
program. The STOP command stops all command levels. If this ON
command is executed in a command procedure, which in turn is
executed from within another procedure, control does not return
to the outer procedure, but to DCL command level 0.
/CPU
Stops the specified secondary processor or processors (and any
associated vector processors) in a VMS multiprocessing system. The
/CPU qualifier is required.
Applies only to VMS multiprocessing systems. Requires CMKRNL
(change mode to kernel) privilege.
Format
STOP/CPU [cpu-id,...]
Additional information available:
Parameter
cpu-id Specifies a decimal value representing the identity of a processor in a VMS multiprocessing system. In a VAX 8300 system, for instance, the CPU ID is the VAXBI node number of the processor; in a VAX 8800, the CPU ID of the left processor is 1 and that of the right processor is 0. If you do not specify a CPU ID, the STOP/CPU command selects a processor in the current active set to stop.
Qualifiers
Additional information available:
/ALL
Stops all eligible secondary processors in the system's active set.
/OVERRIDE_CHECKS
Directs the STOP/CPU command to bypass a series of checks that determine whether the specified processor is eligible for removal from the active set.
Examples
1. $ STOP/CPU
The STOP/CPU command in this example selects a processor and
removes it from the multiprocessing system's active set.
2. $ STOP/CPU 4,7
The STOP/CPU command in this example selects the processors
with CPU IDs 4 and 7 and removes them from the multiprocessing
system's active set.
3. $ STOP/CPU/OVERRIDE_CHECKS 8
The STOP/CPU/OVERRIDE_CHECKS command in this example
unconditionally stops the processor with the CPU ID of 8 and
removes it from active participation in the multiprocessing
system.
4. $ STOP/CPU/ALL
The STOP/CPU/ALL command in this example stops all eligible
secondary processors in the active set and removes them from
the multiprocessing system.
/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 can be initiated. The /QUEUE qualifier is required.
Requires OPER (operator) privilege or execute (E) access to the
queue.
STOP/QUEUE performs different functions with certain qualifiers
as follows:
o Cause executing jobs in the specified output queue to be
stopped (see /ABORT).
o Cause executing jobs in the specified batch queue to be stopped
(see /ENTRY).
o Perform an orderly shutdown of the system job queue manager on
the node from which the command is issued (see /MANAGER).
o Cause the specified queue to stop after all executing jobs have
completed processing (see /NEXT).
o Cause the executing jobs in the specified queue to be stopped
and requeue it for later processing (see /REQUEUE).
o Abruptly stop the queue and return control to the system (see
/RESET).
Format
STOP/QUEUE queue-name[:]
Additional information available:
/ABORT/ENTRY/MANAGER/NEXT/REQUEUE/RESET
PARAMETER
queue-name[:] Specifies the name of the queue that you want to pause.
EXAMPLES
1. $ STOP/QUEUE LPA0
The STOP/QUEUE command in this example halts the current print
job in the queue LPA0 and places that queue in the paused
state.
2. $ STOP/QUEUE TEXTBATCH
.
.
.
$ START/QUEUE/BLOCK_LIMIT=500 TEXTBATCH
The STOP/QUEUE command in this example halts all batch jobs
that are currently executing on the queue TEXTBATCH and places
that queue in the paused state. Later the START/QUEUE command
releases the queue from the paused state. All the jobs that
were halted resume processing, but the START/QUEUE command now
limits any further jobs to 500 blocks or smaller.
/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 OPER (operator) privilege, execute (E) access to the
queue, or delete (D) access to the current job.
Format
STOP/QUEUE/ABORT queue-name[:]
Additional information available:
PARAMETER
queue-name[:] Specifies the name of the queue containing the job you want to abort.
Example
$ STOP/QUEUE/ABORT LPA0
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.
/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 OPER (operator) privilege, execute (E) access to the
queue, or delete (D) access to the current job.
Format
STOP/QUEUE/ENTRY=(entry-number[,...]) [queue-name[:]]
Additional information available:
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 VMS operating system uses it to verify an entry in the specific queue before stopping and deleting the entry.
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.
/MANAGER
Performs an orderly shutdown of the system job queue manager on
the node from which the command is entered. The /QUEUE qualifier
is optional, but the /MANAGER qualifier is required.
Requires both OPER (operator) and SYSNAM (system logical name)
privileges.
Format
STOP/QUEUE/MANAGER
Additional information available:
Example
$ STOP/QUEUE/MANAGER
The STOP/QUEUE/MANAGER command in this example performs a
shutdown of all queues on the node from which the command is
entered.
/NEXT
Stops the specified queue after all executing jobs have completed
processing. No new jobs can be initiated; the START/QUEUE command
restarts the queue. The /QUEUE qualifier is optional, but you must
specify the /NEXT qualifier.
Requires OPER (operator) privilege or execute (E) access to the
specified queue.
Format
STOP/QUEUE/NEXT queue-name[:]
Additional information available:
PARAMETER
queue-name[:] Specifies the name of the queue that you want to stop.
EXAMPLES
1. $ STOP/QUEUE/NEXT BATCH1
In this example, the STOP/QUEUE/NEXT command prepares to stop
the queue BATCH1. All currently executing jobs are allowed to
complete, but no new jobs are allowed to initiate. Once all
current jobs have finished, the queue is stopped.
2. $ STOP/QUEUE/NEXT LPA0
$ SHOW QUEUE/ALL LPA0
Printer queue LPA0
$ DELETE/QUEUE LPA0
This example shows how to delete the printer queue LPA0. First,
the STOP/QUEUE/NEXT command is entered, which stops the printer
after the current job is printed. Then 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
printer queue LPA0.
/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 OPER (operator) privilege, execute (E) access to the
queue or delete (D) access to the current job.
Format
STOP/QUEUE/REQUEUE[=queue-name] queue-name[:]
STOP/QUEUE/REQUEUE/ENTRY=(entry-number[,...])
[=queue-name]
queue-name[:]
Additional information available:
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.
QUALIFIERS
Additional information available:
/ENTRY
/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
/PRIORITY=n
Requires OPER (operator) or ALTPRI (alter privilege) privilege to
raise the priority value above the value of the SYSGEN parameter
MAXQUEPRI.
Changes the priority of the requeued job or jobs. The n parameter
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 it was
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.
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.
/RESET
Abruptly stops the queue and returns control to the system. Any
jobs currently executing are stopped immediately. The START/QUEUE
command restarts the queue. Current jobs that can be restarted
(all print jobs and any batch jobs submitted with the /RESTART
qualifier) are requeued for processing. Current jobs that cannot
be restarted are aborted and must be resubmitted for processing.
The /QUEUE qualifier is optional, but you must specify the /RESET
qualifier.
Requires OPER (operator) privilege or execute (E) access to the
specified queue.
Format
STOP/QUEUE/RESET queue-name[:]
Additional information available:
PARAMETER
queue-name[:] Specifies the name of the queue you want to reset.
EXAMPLES
1. $ STOP/QUEUE/RESET LPA0
The STOP/QUEUE/RESET command in this example abruptly stops the
printer queue LPA0. The current print job stops immediately.
2. $ STOP/QUEUE/RESET TEXBATCH
The STOP/QUEUE/RESET command in this example stops the
TEXBATCH queue. Any current job that was submitted with the
/RESTART qualifier is requeued for processing when the queue
is restarted. Current jobs that did not specify the /RESTART
qualifier must be resubmitted to the queue.
/ZONE
Used to deconfigure (remove) a zone from the VAXft 3000. For more
information on STOP/ZONE, refer to the VAXft System Services
Reference Guide.
Format
STOP/ZONE zone-id[/qualifiers]
Requires CMKRNL (change mode to kernel) privilege.