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: STOP Qualifier(s) Function /CPU Stops the specified secondary processor or processors (and any associated vector processors) in an OpenVMS multiprocessing system. /NETWORK Stops the specified network service on the local node. /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/CLUSTER Stops the queue manager throughout the OpenVMS Cluster. /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. /QUEUES/ON_NODE Stops all queues on the specified node. /ZONE Removes a zone from the VAXft series computers. 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. If the process- name includes spaces or lowercase letters, enclose the name in quotation marks (" ") to preserve the correct spelling. 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 is incompatible 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 in specifying the PID code. /IMAGE /IMAGE [/IDENTIFICATION=pid] [process-name] Calls the $FORCEX system service to stop the image of the target process specified in the process id or process name that is currently executing. The target process is not deleted. If you omit the /IDENTIFICATION qualifier and the process name, the STOP/IMAGE command is identical to the STOP command. /EXIT /EXIT[=access-mode] (default) /NOEXIT Specifies an option to call exit handlers prior to deletion of the process. The following table describes the access mode options: Mode Description EXECUTIVE_ Execute executive and more privileged mode exit MODE handlers (default, if no access mode specified). KERNEL_MODE Execute kernel mode exit handlers. SUPERVISOR_ Execute supervisor and more privileged mode exit MODE handlers. USER_MODE Execute user and more privileged mode exit handlers. 2 Examples 1.$ RUN MYPROG . . . 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 . . . Interrupt $ STOP The @ (execute procedure) command in this example executes the procedure TESTALL.COM. Subsequently, the Ctrl/Y function interrupts the procedure. The STOP command then 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. 5.$ STOP/EXIT Terminates the process and runs exit handlers beginning at executive mode. 6.$ STOP/IMAGE/ID=12345678 Terminates the current user image being executed by process 12345678. 2 /CPU Stops the specified secondary processor or processors (and any associated vector processors). The /CPU qualifier is required. Applies only to OpenVMS 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 an OpenVMS multiprocessing system. On an Alpha 7000 system, the CPU ID is the backplane slot number of the processor. 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. /ASSIGN /ASSIGN=option (Alpha/Integrity servers only) Assigns specified processors to the hard partition node after they are stopped. Option Description $$HARD_ The configuration tree hard partition node. All PARTITION instances running in the hard partition defined by this node have visibility and access to CPUs owned at this level. Supported only on AlphaServer systems that support partitioning. /MIGRATE /MIGRATE (Alpha/Integrity servers only) Transfers ownership of the CPU from the current instance to another soft partition. Option Description instance_name The name of any valid running instance in the current hard partition. partitionID The numeric ID of any partition (reflected in the configuration tree) in the current hard partition. An operating system instance is not required to be running with this identifier. Supported only on AlphaServer systems that support partitioning. /OVERRIDE_CHECKS Directs the STOP/CPU command to bypass a series of OpenVMS scheduling checks that determine whether the specified processor is eligible for removal from the active set. Note that this is not an unconditional operation; other CPU load or configuration constraints may prevent the specified processor from being stopped. /POWER /POWER=OFF (Alpha/Integrity servers only) Powers down the CPU after it is removed from the active set. The CPU will be powered down while still owned by the instance, prior to any assignments. The /POWER qualifier cannot be used in conjunction with the /MIGRATE qualifier. Supported only on AlphaServer GS series systems. 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 overrides some OpenVMS scheduling states that ordinarily prevent the operation and stops the processor with the CPU ID of 8. Then it is removed 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. 5.$ STOP/CPU/MIGRATE=WFGLXE 5 The STOP/CPU/MIGRATE command in this example removes CPU 5 from the current instance's active set and transfers ownership to instance WFGLXE in the current hard partition. 6.$ STOP/CPU/ASSIGN=$$HARD 6 The STOP/CPU/MIGRATE command in this example removes CPU 6 from the current instance's active set and transfers ownership to the hard partition node in the configuration tree. The CPU is immediately available for assignment for any instance within the hard partition defined by that node. 2 /NETWORK Stops the specified network service on the local node. The /NETWORK qualifier is required. Format STOP/NETWORK network-service 3 Parameter network-service Specifies the name of the network service that you want to halt. 3 Example $ STOP/NETWORK DECnet The STOP/NETWORK command in this example stops the current network service. 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 are initiated. The /QUEUE qualifier is required. Requires manage (M) access to the queue. The STOP/QUEUE command performs different functions when used with certain qualifiers as follows: STOP Qualifier(s) Function /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/CLUSTER Stops the queue manager throughout the OpenVMS Cluster. /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. /QUEUES/ON_NODE Stops all queues on the specified node. 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 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. 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 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. For batch queues an entry number must be provided. To abort a batch job, use the STOP/QUEUE/ENTRY command. 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 delete (D) access to the specified 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 OpenVMS 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 4 /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. 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: o Aborts all current jobs that cannot be restarted, and requeues all current restartable jobs. o