HELPLIB.HLB  —  Lexicals  F$GETJPI
    Returns information about the specified process.

    Requires GROUP privilege to obtain information on other processes
    in the same group. Requires WORLD privilege to obtain information
    on any other processes in the system.

    Format

      F$GETJPI(pid,item)

1  –  Return Value

    Either an integer or a character string, depending on the item
    you request.

2  –  Arguments

 pid

    Specifies the process identification (PID) number of the process
    for which information is being reported. Specify the pid argument
    as a character string expression. You can omit the leading zeros.

    If you specify a null string (""),  the current PID number is
    used.

    You cannot use an asterisk (*)  or percent sign (%) wildcard
    character to specify the pid argument in the F$GETJPI function,
    as you can with the $GETJPI system service. To get a list of
    process identification numbers, use the F$PID function.

 item

    Indicates the type of process information to be returned. Specify
    the item argument as a character string expression. You can
    specify any one of the following items:

    ACCOUNT              APTCNT                 ASTACT
    ASTCNT               ASTEN                  ASTLM
    AUTHPRI              AUTHPRIV               BIOCNT
    BIOLM                BUFIO                  BYTCNT
    BYTLM                CASE_LOOKUP_IMAGE*     CASE_LOOKUP_PERM*
    CLASSIFICATION*      CLINAME                CPULIM
    CPUTIM               CREPRC_FLAGS           CURPRIV
    CURRENT_CAP_MASK*    DFPFC                  DFWSCNT
    DIOCNT               DIOLM                  DIRIO
    EFCS                 EFCU                   EFWM
    ENQCNT               ENQLM                  EXCVEC
    FAST_VP_SWITCH       FILCNT                 FILLM
    FINALEXC             FREP0VA                FREP1VA
    FREPTECNT            GPGCNT                 GRP
    HOME_RAD            IMAGECOUNT             IMAGE_AUTHPRIV*
    IMAGE_PERMPRIV*      IMAGE_WORKPRIV*        IMAGNAME
    IMAGPRIV             INSTALL_RIGHTS*        INSTALL_RIGHTS_SIZE*
    JOBPRCCNT            JOBTYPE                LAST_LOGIN_I
    LAST_LOGIN_N         LOGIN_FAILURES         LOGIN_FLAGS
    LOGINTIM             MASTER_PID             MAXDETACH
    MAXJOBS              MEM                    MODE
    MSGMASK              MULTITHREAD            NODENAME
    NODE_CSID            NODE_VERSION           OWNER
    PAGEFLTS             PAGFILCNT              PAGFILLOC
    PARSE_STYLE_PERM*    PARSE_STYLE_IMAGE*     PERMANENT_CAP_MASK*
    PERSONA_AUTHPRIV*    PERSONA_ID*            PERSONA_PERMPRIV*
    PERSONA_RIGHTS*      PERSONA_RIGHTS_SIZE*   PERSONA_WORKPRIV*
    PGFLQUOTA            PHDFLAGS               PID
    PPGCNT               PRCCNT                 PRCLM
    PRCNAM               PRI                    PRIB
    PROC_INDEX           PROCESS_RIGHTS         PROCPRIV
    RIGHTSLIST           RIGHTS_SIZE            SCHED_CLASS_NAME*
    SEARCH_SYMLINK_TEMP  SEARCH_SYMLINK_PERM
    SHRFILLM             SITESPEC               SLOW_VP_SWITCH
    STATE                STS                    STS2
    SUBSYSTEM_RIGHTS*    SUBSYSTEM_RIGHTS_SIZE* SWPFILLOC
    SYSTEM_RIGHTS        SYSTEM_RIGHTS_SIZE*    TABLENAME
    TERMINAL             TMBU                   TOKEN
    TQCNT                TQLM                   TT_ACCPORNAM
    TT_PHYDEVNAM         UAF_FLAGS              UIC
    USERNAME             VIRTPEAK               VOLUMES
    VP_CONSUMER          VP_CPUTIM              WSAUTH
    WSAUTHEXT            WSEXTENT               WSPEAK
    WSQUOTA              WSSIZE

    * Alpha only

3  –  Examples

    1.$ NAME = F$GETJPI("3B0018","USERNAME")
      $ SHOW SYMBOL NAME
        NAME = "JANE        "

      This example shows how to use the F$GETJPI function to return
      the user name for the process number 3B0018. The user name is
      assigned to the symbol NAME.

    2.$ X=F$ENVIRONMENT("MESSAGE")
      $ SHOW SYMBOL X
        X = "/FACILITY/SEVERITY/IDENTIFICATION/TEXT"
      $ X=F$GETJPI("0","MSGMASK")
      $ SHOW SYMBOL X
        X = 15   Hex = 0000000F  Octal = 00000000017
      $ SET MESSAGE /NOFACILITY
      $ X=F$ENVIRONMENT("MESSAGE")
      $ SHOW SYMBOL X
        X = "/NOFACILITY/SEVERITY/IDENTIFICATION/TEXT"
      $ X=F$GETJPI("0","MSGMASK")
      $ SHOW SYMBOL X
        X = 7   Hex = 00000007  Octal = 00000000007
      $ SET MESSAGE /FACILITY
      $ X=F$ENVIRONMENT("MESSAGE")
      $ SHOW SYMBOL X
        X = "/FACILITY/SEVERITY/IDENTIFICATION/TEXT"
      $ X=F$GETJPI("0","MSGMASK")
      $ SHOW SYMBOL X
        X = 15   Hex = 0000000F  Octal = 00000000017
      $

      This example shows the use of the F$GETJPI MSGMASK item.
Close Help