1  STOP
   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:

   Table DCL-1 STOP Command Qualifiers

   STOP Qualifier(s)        Function

   /CPU                     Stops the specified secondary processor
                            or processors (and any associated vector
                            processors) in a VMS multiprocessing
                            system.

   /IDENTIFICATION          Stops the specified process.  Additional
                            qualifiers /NOW, /PATIENCE, /FORCEX,
                            /DELPRC and /VERBOSE may be used to 
                            supplement default action.

   /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/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.

   /WILD                    Stops the specified processes.  Additional
                            qualifiers /NOW, /PATIENCE, /FORCEX,
                            /DELPRC and /VERBOSE may be used to 
                            supplement default action.

   /ZONE                    Removes a zone from the VAXft 3000.

2  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.

2  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, or specify a wildchard process name while
   using the /WILD qualifier.

   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.

2  Qualifiers

/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 and the leftmost four hexadecimal
   digits when specifying the PID code of the process.



2  /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,...]

3  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.

3  Qualifiers

/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.

3 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.

2  /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.

   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[:]

3  PARAMETER

queue-name[:]
   Specifies the name of the queue that you want to pause.

3  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.


3  /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[:]

4  PARAMETER

queue-name[:]
   Specifies the name of the queue containing the job you want to
   abort.

4  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.


3  /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[:]]

4  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.

4  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.


3  /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

4  Parameters
   None.

4  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.


3  /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[:]

4  PARAMETER

queue-name[:]
   Specifies the name of the queue that you want to stop.

4  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.


3  /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[:]

4  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.

4  QUALIFIERS

/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.

4  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.


3  /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[:]

4  PARAMETER

queue-name[:]
   Specifies the name of the queue you want to reset.

4  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.

2  /WILD
   Used to specify wildcarded process names for STOP to work on.

      Format:  STOP/WILD process_name_wild[/extended_qualifiers]


3  EXAMPLES

	STOP/WILD "johnson*"            Kills all jobs whose process 
                                        name starts with "johnson".

	STOP/WILD/FORCEX/NODELPRC "j*"  Stops executing images on all 
                                        processes with names starting
                                        with "j".

        STOP/WILD/NOW/VERBOSE "FIELD_%" Kills all field subprocesses,
                                        while displaying debugging 
                                        information.

        STOP/WILD/PATIENCE "BATCH*"     Waits for graceful image rundown
                                        while terminating batch jobs.


2  /ZONE
   Used to deconfigure a zone on a VAXft 3000.

   Format

     STOP/ZONE  zone-id[/qualifiers]

3  Restrictions

   o  Applies only to the VAXft 3000.

   o  Requires CMKRNL (change mode to kernel) privilege.

3  Description
   STOP/ZONE is used to remove a zone from the VAXft 3000. For more
   information on STOP/ZONE, refer to the VAXft System Services
   Reference Guide.

2  Extended_Qualifiers 

  (Used with /IDENTIFICATION and /WILD only)

/DELPRC

     /DELPRC   [D]
     /NODELPRC

   Specifies that the process will be deleted from the system.
   Negating this qualifier allows affecting the process by other
   means (for example, by forcing an image exit) while leaving the
   process itself intact.

/FORCEX

     /FORCEX   [D]
     /NOFORCEX

   Specifies that the image currently being run by the process will
   be terminated.  This qualifier uses the $FORCEX system service.

/NOW

     /NOW

   Specifies that the process in question will have no sanity checks
   done on it or any running images.  It will be terminated.

/PATIENCE
 
     /PATIENCE

   Specifies that extra time will be allowed the process for graceful
   image exit.  This qualifier is not valid when used with the /NOW
   qualifier.

/VERBOSE

     /VERBOSE

   Specifies that debugging information about the checks and system 
   service calls made by the stop command will be reported.



