Library /sys$common/syshlp/helplib.hlb  —  System Services, $FORCEX
    Causes an Exit ($EXIT) service call to be issued on behalf of a
    specified process.

    Format

      SYS$FORCEX  [pidadr] ,[prcnam] ,[code]

    C Prototype

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

                      int code);

1  –  Arguments

 pidadr

    OpenVMS usage:process_id
    type:         longword (unsigned)
    access:       modify
    mechanism:    by reference
    Process identification (PID) of the process to be forced to exit.
    The pidadr argument is the address of a longword containing the
    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.

    The pidadr argument is optional but must be specified if the
    process that is to be forced to exit is not in the same UIC group
    as the calling process.

 prcnam

    OpenVMS usage:process_name
    type:         character-coded text string
    access:       read only
    mechanism:    by descriptor-fixed-length string descriptor
    Process name of the process that is to be forced to exit. The
    prcnam argument is the address of a character string descriptor
    pointing to the process name string. 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 in 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.

    The prcnam argument can be used only on behalf of processes in
    the same UIC group as the calling process. To force processes in
    other groups to exit, you must specify the pidadr argument. This
    restriction exists because the operating system interprets the
    UIC group number of the calling process as part of the specified
    process name; the names of processes are unique to UIC groups.

 code

    OpenVMS usage:cond_value
    type:         longword (unsigned)
    access:       read only
    mechanism:    by value
    Completion code value to be used as the exit parameter. The
    code argument is a longword containing this value. If you do
    not specify the code argument, the value 0 is passed as the
    completion code.
Close Help