View source for F$GETJPI

'''F$GETJPI''' is a [[Lexical functions|lexical function]] that 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. 

=Syntax=

F$GETJPI(pid,item)

=Return Value=

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

=Arguments=

==pid==
Specifies the [[PID|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: 

{| class="wikitable"
! colspan="col" | Item
! colspan="col" | Information returned
! colspan="col" | Example
|-
| ACCOUNT
| UIC account of the process (8 characters filled with trailing blanks)
| 
 $ a = f$getjpi("","account")
 $ show sym a
  A = "SYSTEM  "
|-
| APTCNT
| Active page table count
|  
 a = f$getjpi("","APTCNT")
 $ show sym a
  A = 0   Hex = 00000000  Octal = 00000000000
|-
| ASTACT
| Access modes with active asynchronous system traps (ASTs).
| 
 $ a = f$getjpi("","ASTACT")
 $ show sym a
  A = 0   Hex = 00000000  Octal = 00000000000
|-
| ASTCNT
| Remaining AST quota.
| 
 $ a = f$getjpi("","ASTCNT")
 $ show sym a
  A = 248   Hex = 000000F8  Octal = 00000000370
|-
| ASTEN
| Access modes with ASTs enabled.
| 
 $ a = f$getjpi("","ASTEN")
 $ show sym a
  A = 15   Hex = 0000000F  Octal = 00000000017
|-
| ASTLM
| AST limit quota.
| 
 $ a = f$getjpi("","ASTLM")
 $ show sym a
  A = 250   Hex = 000000FA  Octal = 00000000372
|-
| AUTHPRI
| Maximum priority that a process without the [[ALTPRI]] (alter priority) privilege can achieve with the [[$SETPRI]] system service.
| 
 $ a = f$getjpi("","AUTHPRI")
 $ show sym a
  A = 4   Hex = 00000004  Octal = 00000000004
|-
| AUTHPRIV
| Privileges that the process is authorized to enable.
| 
 $ a = f$getjpi("","AUTHPRIV")
 $ show sym a
  A = "CMKRNL,CMEXEC,SYSNAM,GRPNAM,ALLSPOOL,DETACH,DIAGNOSE,LOG_IO,GROUP,ACNT,PRMCEB,PRMMBX,PSWAPM,ALTPRI,SETPRV,
 TMPMBX,WORLD,MOUNT,OPER,EXQUOTA,NETMBX,VOLPRO,PHY_IO,BUGCHK,PRMGBL,SYSGBL,PFNMAP,SHMEM,
 SYSPRV,BYPASS,SYSLCK,SHARE,UPGRADE,DOWNGRADE,GRPPRV,READALL,IMPORT,AUDIT,SECURITY"
|-
| BIOCNT
| Remaining buffered I/O quota.
| 
 $ a = f$getjpi("","BIOCNT")
 $ show sym a
  A = 150   Hex = 00000096  Octal = 00000000226
|-
| BIOLM
| Buffered I/O limit quota.
| 
 $ a = f$getjpi("","BIOLM")
 $ show sym a
  A = 150   Hex = 00000096  Octal = 00000000226
|-
| BUFIO
| Count of process buffered I/O operations.
| 
 $ a = f$getjpi("","BUFIO")
 $ show sym a
  A = 160899   Hex = 00027483  Octal = 00000472203
|-
| BYTCNT
| Remaining buffered I/O byte count quota.
| 
 $ a = f$getjpi("","BYTCNT")
 $ show sym a
  A = 99424   Hex = 00018460  Octal = 00000302140
|-
| BYTLM
| Buffered I/O byte count quota.
| 
 $ a = f$getjpi("","BYTLM")
 $ show sym a
  A = 99424   Hex = 00018460  Octal = 00000302140
|-
| CASE_LOOKUP_IMAGE*
|
| 
 $ a = f$getjpi("","CASE_LOOKUP_IMAGE")
 $ show sym a
  A = "BLIND"
|-
| CASE_LOOKUP_PERM*
|
| 
 $ a = f$getjpi("","CASE_LOOKUP_PERM")
 $ show sym a
  A = "BLIND"
|-
| CLASSIFICATION*
|
| 
 $ a = f$getjpi("","CLASSIFICATION")
 $ show sym a
  A = ""
|-
| CLINAME
| Current command language interpreter; always returns DCL.
| 
 $ a = f$getjpi("","CLINAME")
 $ show sym a
  A = "DCL"
|-
| CPULIM
| Limit on process CPU time.
| 
 $ a = f$getjpi("","CPULIM")
 $ show sym a
  A = 0   Hex = 00000000  Octal = 00000000000
|-
| CPUTIM
| CPU time used in hundredths of a second.
| 
 $ a = f$getjpi("","CPUTIM")
 $ show sym a
  A = 30077   Hex = 0000757D  Octal = 00000072575
|-
| CREPRC_FLAGS
| Flags specified by the stsflg argument in the [[$CREPRC]] call that created the process.
| 
 $ a = f$getjpi("","CREPRC_FLAGS")
 $ show sym a
  A = 1024   Hex = 00000400  Octal = 00000002000
|-
| CURPRIV
| Current process privileges
| 
 $ a = f$getjpi("","CURPRIV")
 $ show sym a
  A = "CMKRNL,CMEXEC,SYSNAM,GRPNAM,ALLSPOOL,DETACH,DIAGNOSE,LOG_IO,GROUP,ACNT,
 PRMCEB,PRMMBX,PSWAPM,ALTPRI,SETPRV,TMPMBX,WORLD,MOUNT,OPER,EXQUOTA,NETMBX,VOLPRO,
 PHY_IO,BUGCHK,PRMGBL,SYSGBL,PFNMAP,SHMEM,SYSPRV,BYPASS,SYSLCK,SHARE,UPGRADE,DOWNGRADE,
 GRPPRV,READALL,IMPORT,AUDIT,SECURITY"
|-
| CURRENT_CAP_MASK*
|
| 
 $ a = f$getjpi("","CURRENT_CAP_MASK")
 $ show sym a
  A = "0000000C"
|-
| DFPFC
| Default page fault cluster size.
| 
 $ a = f$getjpi("","DFPFC")
 $ show sym a
  A = 64   Hex = 00000040  Octal = 00000000100
|-
| DFWSCNT
| Default working set size
| 
 $ a = f$getjpi("","DFWSCNT")
 $ show sym a
  A = 2048   Hex = 00000800  Octal = 00000004000
|-
| DIOCNT
| Remaining direct I/O quota
| 
 $ a = f$getjpi("","DIOCNT")
 $ show sym a
  A = 150   Hex = 00000096  Octal = 00000000226
|-
| DIOLM
| Direct I/O limit quota.
| 
 $ a = f$getjpi("","DIOLM")
 $ show sym a
  A = 150   Hex = 00000096  Octal = 00000000226
|-
| DIRIO
| Count of direct I/O operations for the process.
| 
 $ a = f$getjpi("","DIRIO")
 $ show sym a
  A = 53521   Hex = 0000D111  Octal = 00000150421
|-
| EFCS
| Local event flags 0--31
| 
 $ a = f$getjpi("","EFCS")
 $ show sym a
  A = 1073741825   Hex = 40000001  Octal = 10000000001
|-
| EFCU
| Local event flags 32--63
| 
 $ a = f$getjpi("","EFCU")
 $ show sym a
  A = -1107296256   Hex = BE000000  Octal = 27600000000
|-
| EFWM
| Event flag wait mask
| 
 $ a = f$getjpi("","EFWM")
 $ show sym a
  A = -33554433   Hex = FDFFFFFF  Octal = 37577777777
|-
| ENQCNT
| Lock request quota remaining
| 
 $ a = f$getjpi("","ENQCNT")
 $ show sym a
  A = 2000   Hex = 000007D0  Octal = 00000003720
|-
| ENQLM
| Lock request quota limit
| 
 $ a = f$getjpi("","ENQLM")
 $ show sym a
  A = 2000   Hex = 000007D0  Octal = 00000003720
|-
| EXCVEC
| Address of a list of exception vectors
| 
 $ a = f$getjpi("","EXCVEC")
 $ show sym a
  A = "7FFF0130"
|-
| FAST_VP_SWITCH
| Number of times this process has issued a vector instruction that enabled an inactive vector processor without the expense of a vector context switch
| 
 $ a = f$getjpi("","FAST_VP_SWITCH")
 $ show sym a
  A = 0   Hex = 00000000  Octal = 00000000000
|-
| FILCNT
| Remaining open file quota
| 
 $ a = f$getjpi("","FILCNT")
 $ show sym a
  A = 98   Hex = 00000062  Octal = 00000000142
|-
| FILLM
| Open file quota
| 
 $ a = f$getjpi("","FILLM")
 $ show sym a
  A = 100   Hex = 00000064  Octal = 00000000144

|-
| FINALEXC
| Address of a list of final exception vectors
| 
 $ a = f$getjpi("","FINALEXC")
 $ show sym a
  A = "7FFF0230"
|-
| FREP0VA
| First free page at end of program region (P0 space) (irrelevant if no image is running)
| 
 $ a = f$getjpi("","FREP0VA")
 $ show sym a
  A = ""
|-
| FREP1VA
| First free page at end of control region (P1 space).
| 
 $ a = f$getjpi("","FREP1VA")
 $ show sym a
  A = "7AE42000"
|-
| FREPTECNT
| Number of pages available for virtual memory expansion.
| 
 $ a = f$getjpi("","FREPTECNT")
 $ show sym a
  A = 2147483647   Hex = 7FFFFFFF  Octal = 17777777777
|-
| GPGCNT
| Global page count in working set
| 
 $ a = f$getjpi("","GPGCNT")
 $ show sym a
  A = 112   Hex = 00000070  Octal = 00000000160
|-
| GRP
| Group number of the user identification code (UIC)
| 
 $ a = f$getjpi("","GRP")
 $ show sym a
  A = 1   Hex = 00000001  Octal = 00000000001
|-
| HOME_RAD
|
| 
 $ a = f$getjpi("","HOME_RAD")
 $ show sym a
  A = 0   Hex = 00000000  Octal = 00000000000
|-
| IMAGECOUNT
| Number of images that have been run down for the process.
| 
 $ a = f$getjpi("","IMAGECOUNT")
 $ show sym a
  A = 29   Hex = 0000001D  Octal = 00000000035
|-
| IMAGE_AUTHPRIV*
|
| 
 $ a = f$getjpi("","IMAGE_AUTHPRIV")
 $ show sym a
  A = ""
|-
| IMAGE_PERMPRIV*
|
| 
 $ a = f$getjpi("","IMAGE_PERMPRIV")
 $ show sym a
  A = ""
|-
| IMAGE_WORKPRIV*
|
| 
 $ a = f$getjpi("","IMAGE_WORKPRIV")
 $ show sym a
  A = ""
|-
| IMAGNAME
| File name of the current image.
| 
 $ a = f$getjpi("","IMAGNAME")
 $ show sym a
  A = ""
|-
| IMAGPRIV
| Privileges with which the current image was installed
| 
 $ a = f$getjpi("","IMAGPRIV")
 $ show sym a
  A = ""
|-
| INSTALL_RIGHTS*
|
| 
 $ a = f$getjpi("","INSTALL_RIGHTS")
 $ show sym a
   A = ""
|-
| INSTALL_RIGHTS_SIZE*
|
| 
 $ a = f$getjpi("","INSTALL_RIGHTS_SIZE")
 $ show sym a
  A = 0   Hex = 00000000  Octal = 00000000000
|-
| JOBPRCCNT
| Number of subprocesses owned by the job.
| 
 $ a = f$getjpi("","JOBPRCCNT")
 $ show sym a
  A = 0   Hex = 00000000  Octal = 00000000000
|-
| JOBTYPE
| Execution mode of the process at the root of the job tree.
| 
 $ a = f$getjpi("","JOBTYPE")
 $ show sym a
  A = 3   Hex = 00000003  Octal = 00000000003
|-
| LAST_LOGIN_I
| Time of your last interactive login (the value that was reported when you logged in)
| 
 $ a = f$getjpi("","LAST_LOGIN_I")
 $ show sym a
  A = "15-JUN-2019 15:31:08.32"
|-
| LAST_LOGIN_N
| Time of your last noninteractive login (the value that was reported when you logged in)
| 
 $ a = f$getjpi("","LAST_LOGIN_N")
 $ show sym a
  A = "17-NOV-1858 00:00:00.00"
|-
| LOGIN_FAILURES
| Number of login failures that occurred prior to the start of the current session (the value that was reported when you logged in)
| 
 $ a = f$getjpi("","LOGIN_FAILURES")
 $ show sym a
  A = 0   Hex = 00000000  Octal = 00000000000
|-
| LOGIN_FLAGS
| A longword bitmask that contains additional information relating to the login sequence
| 
 $ a = f$getjpi("","LOGIN_FLAGS")
 $ show sym a
  A = 0   Hex = 00000000  Octal = 00000000000
|-
| LOGINTIM
| Process creation time
| 
 $ a = f$getjpi("","LOGINTIM")
 $ show sym a
  A = "23-JUN-2019 11:50:40.78"
|-
| MASTER_PID
| Process identification (PID) number of the process at the top of the current job's process tree
| 
 $ a = f$getjpi("","MASTER_PID")
 $ show sym a
  A = "00000096"
|-
| MAXDETACH
| Maximum number of detached processes allowed the user who owns the process
| 
 $ a = f$getjpi("","MAXDETACH")
 $ show sym a
  A = 0   Hex = 00000000  Octal = 00000000000
|-
| MAXJOBS
| Maximum number of active processes allowed for the user who owns the process
| 
 $ a = f$getjpi("","MAXJOBS")
 $ show sym a
  A = 0   Hex = 00000000  Octal = 00000000000
|-
| MEM
| Member number of the UIC
| 
 $ a = f$getjpi("","MEM")
 $ show sym a
  A = 4   Hex = 00000004  Octal = 00000000004
|-
| MODE
| Current process mode (BATCH, INTERACTIVE, NETWORK, or OTHER)
| 
 $ a = f$getjpi("","MODE")
 $ show sym a
  A = "INTERACTIVE"
|-
| MSGMASK
| Default message mask
| 
 $ a = f$getjpi("","MSGMASK")
 $ show sym a
  A = 15   Hex = 0000000F  Octal = 00000000017
|-
| MULTITHREAD
|
| 
 $ a = f$getjpi("","MULTITHREAD")
 $ show sym a
  A = 0   Hex = 00000000  Octal = 00000000000
|-
| NODENAME
| The name of the OpenVMS Cluster node on which the process is running
| 
 $ a = f$getjpi("","NODENAME")
 $ show sym a
  A = "STUDNT"
|-
| NODE_CSID
| Cluster ID of the OpenVMS Cluster node on which the process is running
| 
 $ a = f$getjpi("","NODE_CSID")
 $ show sym a
  A = ""
|-
| NODE_VERSION
| Operating system version number of the OpenVMS Cluster node on which the process is running
| 
 $ a = f$getjpi("","NODE_VERSION")
 $ show sym a
  A = "V8.4-2L2"
|-
| OWNER
| Process identification number of process owner
| 
 $ a = f$getjpi("","OWNER")
 $ show sym a
  A = ""
|-
| PAGEFLTS
| Count of page faults
| 
 $ a = f$getjpi("","PAGEFLTS")
 $ show sym a
  A = 4308   Hex = 000010D4  Octal = 00000010324
|-
| PAGFILCNT
| Remaining paging file quota
|  
 $ a = f$getjpi("","PAGFILCNT")
 $ show sym a
  A = 95408   Hex = 000174B0  Octal = 00000272260
|-
| PAGFILLOC
| Location of the paging file
| 
 $ a = f$getjpi("","PAGFILLOC")
 $ show sym a
  A = 0   Hex = 00000000  Octal = 00000000000
|-
| PARSE_STYLE_PERM*
|
| 
 $ a = f$getjpi("","PARSE_STYLE_PERM")
 $ show sym a
  A = "TRADITIONAL"
|-
| PARSE_STYLE_IMAGE*
|
| 
 $ a = f$getjpi("","PARSE_STYLE_IMAGE")
 $ show sym a
  A = "TRADITIONAL"
|-
| PERMANENT_CAP_MASK*
|
| 
 $ a = f$getjpi("","PERMANENT_CAP_MASK")
 $ show sym a
  A = "0000000C"
|-
| PERSONA_AUTHPRIV*
|
| 
 $ a = f$getjpi("","PERSONA_AUTHPRIV")
 $ show sym a
  A = "CMKRNL,CMEXEC,SYSNAM,GRPNAM,ALLSPOOL,DETACH,DIAGNOSE,LOG_IO,GROUP,ACNT,
 PRMCEB,PRMMBX,PSWAPM,ALTPRI,SETPRV,TMPMBX,WORLD,MOUNT,OPER,EXQUOTA,NETMBX,VOLPRO,
 PHY_IO,BUGCHK,PRMGBL,SYSGBL,PFNMAP,SHMEM,SYSPRV,BYPASS,SYSLCK,SHARE,UPGRADE,DOWNGRADE,
 GRPPRV,READALL,IMPORT,AUDIT,SECURITY"
|-
| PERSONA_ID*
|
| 
 $ a = f$getjpi("","PERSONA_ID")
 $ show sym a
  A = 1   Hex = 00000001  Octal = 00000000001
|-
| PERSONA_PERMPRIV*
|
| 
 $ a = f$getjpi("","PERSONA_PERMPRIV")
 $ show sym a
  A = "CMKRNL,CMEXEC,SYSNAM,GRPNAM,ALLSPOOL,DETACH,DIAGNOSE,LOG_IO,GROUP,
 ACNT,PRMCEB,PRMMBX,PSWAPM,ALTPRI,SETPRV,TMPMBX,WORLD,MOUNT,OPER,EXQUOTA,
 NETMBX,VOLPRO,PHY_IO,BUGCHK,PRMGBL,SYSGBL,PFNMAP,SHMEM,SYSPRV,BYPASS,SYSLCK,
 SHARE,UPGRADE,DOWNGRADE,GRPPRV,READALL,IMPORT,AUDIT,SECURITY"
|-
| PERSONA_RIGHTS*
|
| 
 $ a = f$getjpi("","PERSONA_RIGHTS")
 $ show sym a
  A = "00010004"
|-
| PERSONA_RIGHTS_SIZE*
|
| 
 $ a = f$getjpi("","PERSONA_RIGHTS_SIZE")
 $ show sym a
  A = 24   Hex = 00000018  Octal = 00000000030
|-
| PERSONA_WORKPRIV*
|
| 
 $ a = f$getjpi("","PERSONA_WORKPRIV")
 $ show sym a
  A = "CMKRNL,CMEXEC,SYSNAM,GRPNAM,ALLSPOOL,DETACH,DIAGNOSE,LOG_IO,GROUP,
 ACNT,PRMCEB,PRMMBX,PSWAPM,ALTPRI,SETPRV,TMPMBX,WORLD,MOUNT,OPER,EXQUOTA,
 NETMBX,VOLPRO,PHY_IO,BUGCHK,PRMGBL,SYSGBL,PFNMAP,SHMEM,SYSPRV,BYPASS,SYSLCK,
 SHARE,UPGRADE,DOWNGRADE,GRPPRV,READALL,IMPORT,AUDIT,SECURITY"
|-
| PGFLQUOTA
| Paging file quota (maximum virtual page count)
| 
 $ a = f$getjpi("","PGFLQUOTA")
 $ show sym a
  A = 100000   Hex = 000186A0  Octal = 00000303240
|-
| PHDFLAGS
| Flags word
| 
 $ a = f$getjpi("","PHDFLAGS")
 $ show sym a
  A = 0   Hex = 00000000  Octal = 00000000000
|-
| PID
| Process identification number
| 
 $ a = f$getjpi("","PID")
 $ show sym a
  A = "00000096"
|-
| PPGCNT
| Process page count
| 
 $ a = f$getjpi("","PPGCNT")
 $ show sym a
  A = 1584   Hex = 00000630  Octal = 00000003060
|-
| PRCCNT
| Number of subprocesses owned by the process
| 
 $ a = f$getjpi("","PRCCNT")
 $ show sym a
  A = 0   Hex = 00000000  Octal = 00000000000
|-
| PRCLM
| Subprocess quota
| 
 $ a = f$getjpi("","PRCLM")
 $ show sym a
  A = 10   Hex = 0000000A  Octal = 00000000012
|-
| PRCNAM
| Process name
| 
 $ a = f$getjpi("","PRCNAM")
 $ show sym a
  A = "SYSTEM"
|-
| PRI
| Process's current priority
| 
 $ a = f$getjpi("","PRI")
 $ show sym a
  A = 4   Hex = 00000004  Octal = 00000000004
|-
| PRIB
| Process's base priority
| 
 $ a = f$getjpi("","PRIB")
 $ show sym a
  A = 4   Hex = 00000004  Octal = 00000000004
|-
| PROC_INDEX
| Process's index number
| 
 $ a = f$getjpi("","PROC_INDEX")
 $ show sym a
  A = 95   Hex = 0000005F  Octal = 00000000137
|-
| PROCESS_RIGHTS
| The contents of the process's local rights list, including your UIC. This item code returns a list of identifier names separated by commas (,)
| 
 $ a = f$getjpi("","PROCESS_RIGHTS")
 $ show sym a
  A = "SYSTEM,INTERACTIVE,LOCAL"
|-
| PROCPRIV
| Process's default privileges
| 
 $ a = f$getjpi("","PROCPRIV")
 $ show sym a
  A = "CMKRNL,CMEXEC,SYSNAM,GRPNAM,ALLSPOOL,DETACH,DIAGNOSE,LOG_IO,GROUP,
 ACNT,PRMCEB,PRMMBX,PSWAPM,ALTPRI,SETPRV,TMPMBX,WORLD,MOUNT,OPER,EXQUOTA,NETMBX,
 VOLPRO,PHY_IO,BUGCHK,PRMGBL,SYSGBL,PFNMAP,SHMEM,SYSPRV,BYPASS,SYSLCK,SHARE,UPGRADE,
 DOWNGRADE,GRPPRV,READALL,IMPORT,AUDIT,SECURITY"
|-
| RIGHTSLIST
| The contents of all of the process rights lists; the equivalent of PROCESS_RIGHTS plus SYSTEM_RIGHTS. This item code returns a list of identifier names separated by commas.
| 
 $ a = f$getjpi("","RIGHTSLIST")
 $ show sym a
  A = "SYSTEM,INTERACTIVE,LOCAL,SYS$NODE_STUDNT"
|-
| RIGHTS_SIZE
| Number of bytes required to buffer the rights list. The rights list includes both the system rights list and the process rights list.
| 
 $ a = f$getjpi("","RIGHTS_SIZE")
 $ show sym a
  A = 32   Hex = 00000020  Octal = 00000000040
|-
| SCHED_CLASS_NAME*
|
| 
 $ a = f$getjpi("","SCHED_CLASS_NAME")
 $ show sym a
  A = ""
|-
| SEARCH_SYMLINK_TEMP
|
| 
 $ a = f$getjpi("","SEARCH_SYMLINK_TEMP")
 $ show sym a
  A = 1   Hex = 00000001  Octal = 00000000001
|-
| SEARCH_SYMLINK_PERM
|
| 
 $ a = f$getjpi("","SEARCH_SYMLINK_PERM")
 $ show sym a
  A = "NOWILDCARD"
|-
| SHRFILLM
| Maximum number of open shared files allowed for the job to which the process belongs
| 
 $ a = f$getjpi("","SHRFILLM")
 $ show sym a
  A = 0   Hex = 00000000  Octal = 00000000000
|-
| SITESPEC
| Per-process site-specific longword
| 
 $ a = f$getjpi("","SITESPEC")
 $ show sym a
  A = 0   Hex = 00000000  Octal = 00000000000
|-
| SLOW_VP_SWITCH
| Number of times this process has issued a vector instruction that enabled an inactive vector processor with a full vector context switch
| 
 $ a = f$getjpi("","SLOW_VP_SWITCH")
 $ show sym a
  A = 0   Hex = 00000000  Octal = 00000000000
|-
| STATE
| Process state
| 
 $ a = f$getjpi("","STATE")
 $ show sym a
  A = "CUR"
|-
| STS
| First longword of process status flags
| 
 $ a = f$getjpi("","STS")
 $ show sym a
  A = 33816577   Hex = 02040001  Octal = 00201000001
|-
| STS2
| Second longword of process status flags
| 
$ a = f$getjpi("","STS2")
$ show sym a
  A = 1   Hex = 00000001  Octal = 00000000001
|-
| SUBSYSTEM_RIGHTS*
|
| 
 $ a = f$getjpi("","SUBSYSTEM_RIGHTS")
 $ show sym a
  A = ""
|-
| SUBSYSTEM_RIGHTS_SIZE*
|
| 
 $ a = f$getjpi("","SUBSYSTEM_RIGHTS_SIZE")
 $ show sym a
  A = 0   Hex = 00000000  Octal = 00000000000
|-
| SWPFILLOC
| Location of the swap file
| 
 $ a = f$getjpi("","SWPFILLOC")
$ show sym a
  A = ""
|-
| SYSTEM_RIGHTS
| The contents of the system rights list for the process. This item code returns a list of identifier names separated by commas.
| 
 $ a = f$getjpi("","SYSTEM_RIGHTS")
 $ show sym a
  A = "SYS$NODE_STUDNT"
|-
| SYSTEM_RIGHTS_SIZE*
|
| 
 $ a = f$getjpi("","SYSTEM_RIGHTS_SIZE")
 $ show sym a
  A = 8   Hex = 00000008  Octal = 00000000010
|-
| TABLENAME
| File specification of the process's current command language interpreter (CLI) table.
| 
 $ a = f$getjpi("","TABLENAME")
 $ show sym a
  A = "STUDNT$DKA0:[SYS0.SYSCOMMON.][SYSLIB]DCLTABLES"
|-
| TERMINAL
| Login terminal name for interactive users (1--7 characters)
| 
 $ a = f$getjpi("","TERMINAL")
 $ show sym a
  A = "OPA0:"
|-
| TMBU
| Termination mailbox unit number.
| 
 $ a = f$getjpi("","TMBU")
 $ show sym a
  A = 0   Hex = 00000000  Octal = 00000000000
|-
| TOKEN
|
| 
 $ a = f$getjpi("","TOKEN")
 $ show sym a
  A = "TRADITIONAL"
|-
| TQCNT
| Remaining timer queue entry quota
| 
 $ a = f$getjpi("","TQCNT")
 $ show sym a
  A = 20   Hex = 00000014  Octal = 00000000024
|-
| TQLM
| Timer queue entry quota.
| 
 $ a = f$getjpi("","TQLM")
 $ show sym a
  A = 20   Hex = 00000014  Octal = 00000000024
|-
| TT_ACCPORNAM
| Access port name for the terminal associated with the process.
| 
 $ a = f$getjpi("","TT_ACCPORNAM")
 $ show sym a
  A = ""
|-
| TT_PHYDEVNAM
| Physical device name of the terminal associated with the process.
| 
 $ a = f$getjpi("","TT_PHYDEVNAM")
 $ show sym a
  A = "_OPA0:"
|-
| UAF_FLAGS
| User authorization file (UAF) flags from the UAF record of the user who owns the process.
| 
 $ a = f$getjpi("","UAF_FLAGS")
 $ show sym a
  A = 0   Hex = 00000000  Octal = 00000000000
|-
| UIC
| Process's user identification code (UIC).
| 
 $ a = f$getjpi("","UIC")
 $ show sym a
  A = "[SYSTEM]"
|-
| USERNAME
| User name string (12 characters filled with trailing blanks)
| 
 $ a = f$getjpi("","USERNAME")
 $ show sym a
  A = "SYSTEM      "
|-
| VIRTPEAK
| Peak virtual address size
| 
 $ a = f$getjpi("","VIRTPEAK")
 $ show sym a
  A = 172128   Hex = 0002A060  Octal = 00000520140
|-
| VOLUMES
| Count of currently mounted volumes
| 
 $ a = f$getjpi("","VOLUMES")
 $ show sym a
  A = 0   Hex = 00000000  Octal = 00000000000
|-
| VP_CONSUMER
| Flag indicating whether the process is a vector consumer
| 
 $ a = f$getjpi("","VP_CONSUMER")
 $ show sym a
  A = "FALSE"
|-
| VP_CPUTIM
| Total amount of time the process has accumulated as a vector customer
| 
 $ a = f$getjpi("","VP_CPUTIM")
 $ show sym a
  A = 0   Hex = 00000000  Octal = 00000000000
|-
| WSAUTH
| Maximum authorized working set size
| 
 $ a = f$getjpi("","WSAUTH")
 $ show sym a
  A = 4096   Hex = 00001000  Octal = 00000010000
|-
| WSAUTHEXT
| Maximum authorized working set extent
| 
 $ a = f$getjpi("","WSAUTHEXT")
 $ show sym a
  A = 28672   Hex = 00007000  Octal = 00000070000
|-
| WSEXTENT
| Current working set extent
| 
 $ a = f$getjpi("","WSEXTENT")
 $ show sym a
  A = 28672   Hex = 00007000  Octal = 00000070000
|-
| WSPEAK
| Working set peak
| 
 $ a = f$getjpi("","WSPEAK")
 $ show sym a
  A = 6352   Hex = 000018D0  Octal = 00000014320
|-
| WSQUOTA
| Working set size quota
| 
 $ a = f$getjpi("","WSQUOTA")
 $ show sym a
  A = 4096   Hex = 00001000  Octal = 00000010000
|-
| WSSIZE
| Process's current working set size.
| 
 $ a = f$getjpi("","WSSIZE")
 $ show sym a
  A = 4448   Hex = 00001160  Octal = 00000010540
|}

=Examples=

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

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

More examples can be found in the Items section above.

[[Category:Lexical Functions]]