Cancels wakeup requests for a specified process, including wakeup requests 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 wakeup requests for processes in the same group but not owned by you o WORLD privilege to cancel scheduled wakeup requests for any process in the system Format CANCEL [[node-name::]process-name]
1 – Parameters
node-name:: 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. process-name 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.
2 – Qualifier
2.1 /IDENTIFICATION
/IDENTIFICATION=pid Identifies the process by its process identification (PID). You can omit leading zeros when you specify the PID.
3 – Examples
1.$ CANCEL CALENDAR 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). 2.$ RUN/SCHEDULE=14:00 STATUS %RUN-S-PROC_ID, identification of created process is 0013012A . . . $ CANCEL/IDENTIFICATION=13012A 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 wakeup request. 3.$ 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.