HELP STOP — VMS 5.2
Terminates execution of:
o A command, image, or command procedure that was interrupted by
CTRL/Y
o A command procedure
o A subprocess or a detached process
For information on pausing and stopping queues, see STOP/QUEUE.
For information on stopping secondary processors in a VMS
multiprocessing system, see STOP/CPU.
Format:
STOP [process-name]
Additional information available:
ParametersCommand QualifiersExamples
Parameters
process-name 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 specify the process-name for a process outside of your group. To stop a process outside of your group, you must use the qualifier /IDENTIFICATION=pid. 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.
Command Qualifiers
Additional information available:
/IDENTIFICATION
/IDENTIFICATION=pid Specifies the process identification code (PID) that the system has assigned to the process. When you create a process with the RUN command, the RUN command displays the process identification code of the newly created process. You can omit any leading zeros in specifying the PID.
Examples
1. $ RUN MYPROG
.
.
.
<CTRL/Y>
Interrupt
$ STOP
The RUN command begins executing the image MYPROG. Subsequently,
CTRL/Y interrupts the execution. The STOP command then terminates
the image.
2. $ @TESTALL
.
.
.
<CTRL/Y>
Interrupt
$ STOP
The @ (Execute Procedure) command executes the procedure
TESTALL.COM. CTRL/Y 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 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 in a VMS
multiprocessing system. The /CPU qualifier is required.
Requires change mode to kernel (CMKRNL) privilege.
Format:
STOP/CPU [cpu-id,...]
Additional information available:
Parameter
cpu-id Decimal value representing the identity of a processor in a 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
/ALL Stops all eligible secondary processors in the system's active set.
/OVERRIDE_CHECKS
/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 selects a processor from the multiprocessing system's active set and attempts to place it in the STOPPED state. 2. $ STOP/CPU 04,07 The STOP/CPU command selects the processors with cpu-ids 04 and 07 and attempts to place them in the STOPPED state. 3. $ STOP/CPU/OVERRIDE_CHECKS 08 The STOP/CPU/OVERRIDE_CHECKS command unconditionally stops the processor with the cpu-id of 08 and removes it from active participation in the multiprocessing system. 4. $ STOP/CPU/ALL The STOP/CPU/ALL command 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. The /QUEUE qualifier is required.
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
requeues 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
Parameters
queue-name[:] Specifies the name of the queue that you want to pause.
Examples
1. $ STOP/QUEUE LPA0
This STOP/QUEUE command 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
This STOP/QUEUE command 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 will 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 privilege, EXECUTE (E) access to the queue, or DELETE
(D) access to the current job.
Format:
STOP/QUEUE/ABORT queue-name[:]
Additional information available:
Parameters
queue-name Specifies the name of the queue containing the job you want to stop.
/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 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 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.
/MANAGER
Performs an orderly shutdown of the system job queue manager on the
node from which the command is issued. The /QUEUE qualifier is
optional, but you must specify the /MANAGER qualifier.
Format:
STOP/QUEUE/MANAGER
/NEXT
Causes the specified queue to stop after all executing jobs have
completed processing. The /QUEUE qualifier is optional, but you
must specify the /NEXT qualifier.
Format:
STOP/QUEUE/NEXT queue-name[:]
Additional information available:
Parameters
queue-name[:] Specifies the name of the queue that you want to stop.
/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 privilege, EXECUTE access to the queue or DELETE 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:
ParametersCommand QualifiersExamples
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.
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 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
/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 or ALTPRI 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 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 privilege or EXECUTE (E) access to the specified
queue.
Format:
STOP/QUEUE/RESET queue-name[:]
Additional information available:
Parameters
queue-name[:] Specifies the name of the queue that you want to reset.