Darya.zelenina: Created page with "'''F$GETJPI''' is a lexical function that returns information about the specified process. Requires GROUP privilege to obtain information on other pr..."

2019-06-28T17:48:32Z

Created page with "'''F$GETJPI''' is a lexical function that returns information about the specified process. Requires GROUP privilege to obtain information on other pr..."

New page

'''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]]

F$GETJPI - Revision history

Darya.zelenina: Created page with "'''F$GETJPI''' is a lexical function that returns information about the specified process. Requires GROUP privilege to obtain information on other pr..."