HP OpenVMS DCL Dictionary
Cancels wakeup requests for a specified process, including wakeup
requests scheduled with either the RUN command or the $SCHDWK system
Requires one of the following:
- Ownership of the process
- GROUP privilege to cancel scheduled wakeup requests for
processes in the same group but not owned by you
- WORLD privilege to cancel scheduled wakeup requests for any
process in the system
The name of the node on which the specified process is running.
You cannot specify a node name on a different OpenVMS Cluster system
from the current process.
The name of the process for which wakeup requests are to be canceled.
The process name can have up to 15 alphanumeric characters.
The specified process must be in the same group as the current process.
The CANCEL command cancels scheduled wakeup requests for the specified
The CANCEL command does not delete the specified process. If the
process is executing an image when the CANCEL command is issued for it,
the process hibernates instead of exiting after the image completes
To delete a hibernating process for which wakeup requests have been
canceled, use the STOP command. You can determine whether a subprocess
has been deleted by entering the SHOW PROCESS command with the
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.
You also can use the /IDENTIFICATION=pid qualifier to specify a process
name. If you use the /IDENTIFICATION qualifier and the
process-name parameter together, the qualifier overrides the
parameter. If you do not specify either the process-name
parameter or the /IDENTIFICATION qualifier, the CANCEL command cancels
scheduled wakeup requests for the current (that is, the issuing)
Identifies the process by its process identification (PID). You can
omit leading zeros when you specify the PID.
The CANCEL command in this example cancels a wakeup request for a
process named CALENDAR (which continues to hibernate until it is
deleted with the STOP command).
$ RUN/SCHEDULE=14:00 STATUS
%RUN-S-PROC_ID, identification of created process is 0013012A
The RUN command in this example 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
$ RUN/PROCESS_NAME=LIBRA/INTERVAL=1:00 LIBRA
%RUN-S-PROC_ID, identification of created process is 00130027
$ CANCEL LIBRA
$ STOP LIBRA
The RUN command in this example creates 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.