Arguments

 

pidadr

   OpenVMS usage:process_id
   type:         longword (unsigned)
   access:       modify
   mechanism:    by reference
   Process identification (PID) of the process to be suspended. The
   pidadr argument is the address of the longword PID.

   The pidadr argument can refer to a process running on the local
   node or a process running on another node in the OpenVMS Cluster
   system.

   You must specify the pidadr argument to suspend a process whose
   UIC group number is different from that of the calling process.
 

prcnam

   OpenVMS usage:process_name
   type:         character-coded text string
   access:       read only
   mechanism:    by descriptor-fixed-length string descriptor
   Name of the process to be suspended. The prcnam argument is the
   address of a character string descriptor pointing to the process
   name. A process running on the local node can be identified with
   a 1- to 15-character string.

   To identify a process on a particular node on a cluster, specify
   the full process name, which includes the node name as well as
   the process name. The full process name can contain up to 23
   characters.

   A process name is implicitly qualified by its UIC group number.
   Because of this, you can use the prcnam argument only to suspend
   processes in the same UIC group as the calling process.

   To suspend processes in other groups, you must specify the pidadr
   argument.
 

flags

   OpenVMS usage:mask_longword
   type:         longword (unsigned)
   access:       read only
   mechanism:    by value
   Longword of bit flags specifying options for the suspend
   operation. Currently, only bit 0 is used for the flags argument.
   When bit 0 is set, the process is suspended at kernel mode and
   ASTs are not deliverable to the process.

   To request a kernel mode suspend, the caller must be in either
   kernel mode or executive mode. The default (bit 0 is clear) is
   to suspend the process at supervisor mode, where executive or
   kernel mode ASTs can be delivered to the process. If executive
   or kernel mode ASTs have been delivered to a process suspended at
   supervisor mode, that process will return to its suspended state
   after the AST routine executes.