1 STOP Terminates execution of a command, image, command procedure, a command procedure that was interrupted by CTRL/Y, or a detached process or subprocess. You must have GROUP privilege to stop other processes in the same GROUP. You must have WORLD privilege to stop processes outside your group. Format STOP [process-name] 2 Parameters process-name Requires that the process be in your group. Name of the process running the command procedure or image. The process name can have from 1 to 15 alphanumeric characters. Incompatible with the /IDENTIFICATION qualifier. 2 Qualifiers /IDENTIFICATION=process-id Specifies the system-assigned process identification. /IDENTIFICATION can be used in place of the process name parameter. /FORCE_ONLY Requests that the destination process's currently executing image be terminated without otherwise killing the process itself. /ERROR=error-code Terminates execution of the currently running image with the error specified by error-code. (Error-code is specified in hexadecimal to be consistent with the DCL variable $STATUS.) /ERROR is only valid when specified with /FORCE_ONLY. 2 /ABORT Aborts the executing print job, deleting it from the queue, and resumes execution of jobs in the queue. (The STOP/ABORT command is equivalent to the STOP/QUEUE/ABORT command.) Format STOP/ABORT queue-name[:] Requires the Secure User Environment Option. Requires OPER privilege, E (execute) access to the queue, or D (delete) access to the current job. 3 Parameters queue-name The name of the queue in which the job is executing. 2 /ENTRY Stops the specified job currently executing in the specified batch queue and resumes execution of the next pending job in the queue. The job number is the number assigned to the job when it is submitted to the queue. (The STOP/ENTRY command is equivalent to the STOP/QUEUE/ENTRY command; use the DELETE/ENTRY command to stop an entry that is queued and pending execution.) Format STOP/ENTRY=entry-number queue-name[:] Requires the Secure User Environment Option. Requires OPER (operator) privilege, E (execute) access to the queue, or D (delete) access to the current job. 3 Parameters queue-name The name of the batch queue in which the job is executing. 2 /QUEUE Stops the specified execution queue. 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 /REQUEUE and /RESET qualifiers provide other ways of stopping queues. To stop individual jobs on the queue, specify the /ABORT, /ENTRY, or /REQUEUE qualifier. Format STOP/QUEUE queue-name Requires the Secure User Environment Option. Requires OPER (operator) privilege or EXECUTE access to the queue. 3 Parameters queue-name Name of the queue. 3 Qualifiers /ABORT Aborts the current print job, deleting it from the queue, and resumes execution of the jobs in the queue. (STOP/QUEUE/ABORT is equivalent to STOP/ABORT.) /ENTRY=job-number Stops the specified job currently executing in a batch queue and resumes execution of the jobs in the queue. To delete an entry that is queued and pending execution, specify the DELETE/ENTRY command. (STOP/QUEUE/ENTRY is equivalent to STOP/ENTRY.) The job number is the number assigned to the job when it is submitted to the queue. /HOLD Places the aborted job on hold; must be used in combination with the /REQUEUE qualifier. To release the job, use the SET QUEUE/ENTRY/RELEASE or SET QUEUE/ENTRY/NOHOLD command; to delete, specify DELETE/ENTRY. /NEXT queue-name Stops the queue after all executing jobs have completed processing. No new jobs can be initiated; the START/QUEUE command will restart the queue. /QUEUE Indicates a stop queue operation. This qualifier is required and must precede all other qualifiers and parameters. /PRIORITY=n Requires OPER or ALTPRI privilege to raise the priority above the value of the MAXQUEPRI parameter. Changes the priority of the aborted job. Must be used with the /REQUEUE qualifier. The value of n is an integer from 0 to 255 that specifies priority; the default is the current priority of the job. /REQUEUE[=queue-name] Stops the current job and requeues it for later processing. Print jobs that have been checkpointed will resume printing at the checkpoint. Batch jobs containing SET RESTART_VALUE commands will run those portions of the job that have not successfully completed. When you use /REQUEUE with a batch queue, you must also use /ENTRY. If you specify a queue name, the current job is transferred to another queue. /RESET Stops the queue without first terminating currently executing jobs. The START/QUEUE command restarts the queue. Current jobs that are restartable (all print jobs and any batch jobs submitted with the /RESTART qualifier) will be requeued for processing. Current jobs that are not restartable are aborted and must be resubmitted for processing. 3 /MANAGER Performs an orderly shutdown of the system job queue manager. Format STOP/QUEUE/MANAGER Requires the Secure User Environment Option. Requires both OPER and SYSNAM privilege. 2 /REQUEUE Stops the current job on the specified queue and requeues it for later processing; execution of the next pending job in the queue resumes. Print jobs that have been checkpointed will resume printing at the checkpoint. Batch jobs (specify /ENTRY) containing SET RESTART_VALUE commands will run those portions of the job that have not successfully completed. Format STOP/REQUEUE[=queue-name] queue-name[:] Requires the Secure User Environment Option. Requires OPER (operator) privilege, E (execute) access to the queue, or D (delete) access to the current job. 3 Parameters queue-name The first queue-name ([=queue-name]) optionally specifies a queue to which the job is to be requeued. The second, required queue-name (queue-name[:]) specifies the name of the queue in which the job is executing. 3 Qualifiers /ENTRY=job-number Required with batch queues to specify the job; the job-number is the number assigned to the job when it was submitted to the queue. /HOLD Places the aborted job in a hold state for later release with the SET/QUEUE /ENTRY/RELEASE or SET QUEUE/ENTRY/NOHOLD command. (Use DELETE/ENTRY to delete a job in the hold state.) /PRIORITY=n Requires either OPER (operator) privilege or ALTPRI (alter priority) privilege to raise the priority value above the value of the SYSGEN parameter MAXQUEPRI. Changes the priority of the requeued job. The value of n can be from 0 to 255; the default value of n is the job's current priority value.