$ZGETJPI()

Examples of $ZGETJPI()

The $ZGETJPI function returns an item of job or process information about a specified process. The $ZGETJPI function is analogous to the DCL F$GETJPI lexical function.

The format for the $ZGETJPI function is:

    $ZGETJPI(expr1,expr2)
    

$ZGETJPI() provides a tool for examining the characteristics of a VMS process and the job in which it operates. Accessing information about processes belonging to other users requires certain VMS privileges. Consult your system manager if you feel you require additional privileges.

The function $ZGETJPI($J,"TERMINAL") returns the output device only when the process is the first (master) process with a job. Within a spawned process, the VMS system service used by $ZGETJPI returns a null string for the item TERMINAL. However, the following alternative acquires the PID of the primary process and uses that to in turn get the terminal.

    $ZGETJPI($ZGETJPI($J,"MASTER_PID"),"TERMINAL")
    

$ZGETJPI() Item Keywords

ITEM KEYWORD

$ZGETJPI() DATA RETURNED

ACCOUNT

APTCNT

ASTACT

ASTCNT

ASTEN

Account name string (8 characters filled with trailing blanks)

Active page table count

Access mode with active ASTs

Remaining AST quota

Access modes with ASTs enabled

ASTLM

AUTHPRI

BLOCNT

BIOLM

BUFIO

AST limited quota

Maximum priority available without the ALTPRI privilege

Privileges a process can enable

Remaining buffered I/O quote

Count of buffered I/O operations

BYTCNT

BYTLM

CLINAME

CPULIM

CPUTIM

Remaining buffered I/O byte-count quota

Buffered I/O byte-count limit quota

Current command language interpreter

Limit on process CPU time

CPU time used in hundredths of a second

CREPRCFLAGS

CURPRIV

DFPFC

DFWSCNT

DIOCNT

Create process flags

Current process privileges

Default page fault cluster size

Default working set size

Remaining direct I/O quota

DIOLM

DIRIO

EFCS

EFCU

EFWM

Direct I/O limit quota

Count of direct I/O operations

Local event flags 0 through 31

Local event flags 32 through 63

Event flag wait mask

ENQCNT

ENQLM

EXCVEC

FILCNT

FILLM

Lock request quota remaining

Lock request quota limit

Address of a list of exception vectors

Remaining open file quota

Open file quota

FINALEXC

FREPOVA

FREP1VA

FREPTECNT

GPGCNT

Address of final exception vectors list

First free page at end of program region

First free page at end of control region

Number of pages available for virtual memory expansion

Global page count in working set

GRP

IMAGECOUNT

IMAGNAME

IMAGPRIV

Group number in UIC

Number of images from which the process has exited (without regard to reason)

File name of the current image

Privileges with which the current image was installed

JOBPRCCNT

JOBTYPE

LOGINTIM

MASTER_PID

MAXDETACH

Number of subprocesses in the process

Job type (0=detach, 1=network, 2=batch, 3=interactive)

Process creation time

PID of the process at the top of the current job’s process tree

Maximum number of detach jobs allowed

MAXJOBS

MEM

MSGMASK

OWNER

PAGEFLTS

Maximum number of jobs allowed

Member number of UIC

Default message mask

PID of process owner

Count of page faults

PAGFILCNT

PAGFILLOC

PGFLQUOTA

PHDFLAGS

PID

Remaining paging file quota

Location of the paging file

Paging file quota (maximum virtual page count)

Flags word

Process identification number

PPBCNT

PRCCNT

PRCLM

PRCNAM

PRI

Process page count

Count of the subprocesses

Subprocess quota

Process name

Current process priority

PRIB

PROCINDEX

PORCPRIV

SHRFILLM

SITESPEC

Base process priority

System table index for the process

Current process privileges

Shared file limit

Per-process site-specified longword

STATE

STS

SWPFILLOC

TABLENAME

TERMINAL

Process state

Process status flags

Location fo the swap file

CLI table name

Login terminal name, if interactive

TMBU

TQCNT

TQLM

UAFLAGS

UIC

Termination mailbox unit number, if detached

Remaining timer queue entry quota

Timer queue entry quota

UAF flags for the account

UIC of the process

USERNAME

VIRTPEAK

VOLUMES

WSAUTH

WAUTHEXT

User name string

Peak virtual address size

Count of currently mounted volumes

Maximum authorized working set size

Maximum authorized working set extent

WSEXTENT

WSPEAK

WSQUOTA

WSSIZE

Current working set extent

Working set peak

Working set size quota

Current working set size