HELPLIB.HLB  —  System Services, $SUSPND
    Allows a process to suspend itself or another process.

    Format

      SYS$SUSPND  [pidadr] ,[prcnam] ,[flags]

    C Prototype

      int sys$suspnd  (unsigned int *pidadr, void *prcnam, unsigned

                      int flags);

1  –  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.
Close Help