Museum

Home

Lab Overview

Retrotechnology Articles

⇒ Online Manual

Media Vault

Software Library

Restoration Projects

Artifacts Sought

Related Articles

Parameters

Command Qualifiers

Examples

/IDENTIFICATION

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

 /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.

Typewritten Software • bear@typewritten.org • Edmonds, WA 98026