HELP CANCEL — VMS 5.2
Cancels wakeup requests for a specified process, including wakeups
scheduled with either the RUN command or the $SCHDWK system
service. Requires one of the following:
o Ownership of the process.
o GROUP privilege to cancel scheduled wakeups for processes in
the same group but not owned by you.
o WORLD privilege to cancel scheduled wakeups for any process in
the system.
Format:
CANCEL [process-name]
Additional information available:
ParametersCommand QualifiersExamples
Parameters
process-name Specifies the name of the process for which wakeup requests are to be canceled. Process names can have up to 23 alphanumeric characters and must be in the following format: [node-name::]process-name o The node name can have up to 6 alphanumeric characters. o The colons count for 2 characters. o The process name can have up to 15 characters. A local process name can look like a remote process name. Therefore, if you specify ATHENS::SMITH, the system checks for a process named ATHENS::SMITH on the local node before checking node ATHENS for a process named SMITH. The specified process must have the same group number in its user identification code (UIC) as the current process. If both the /IDENTIFICATION qualifier and the process name are specified, the process name is ignored. If neither the process-name parameter nor the /IDENTIFICATION qualifier is specified, the CANCEL command cancels scheduled wakeup requests for the current (that is, the issuing) process.
Command Qualifiers
Additional information available:
/IDENTIFICATION
/IDENTIFICATION=pid Identifies the process by its process identification (PID). You can omit leading zeros when you specify the PID.
Examples
1. $ RUN/SCHEDULE=14:00 STATUS
%RUN-S-PROC_ID, identification of created process is 0013012A
.
.
.
$ CANCEL/IDENTIFICATION=13012A
In this example, the RUN command creates a process to execute the
image STATUS. The process hibernates and is scheduled to be awakened
at 14:00. Before the process is awakened, the CANCEL command cancels
the wakeup request.
2. $ RUN/PROCESS_NAME=LIBRA/INTERVAL=1:00 LIBRA
%RUN-S-PROC_ID, identification of created process is 00130027
.
.
.
$ CANCEL LIBRA
$ STOP LIBRA
In this example, the RUN command a subprocess named LIBRA to execute
the image LIBRA.EXE at hourly intervals.
Subsequently, the CANCEL command cancels the wakeup request. The
process continues to exist, but in a state of hibernation, until the
STOP command deletes it.