Returns job or process information of the specified process. The format for the $ZGETJPI function is:
$ZGETJPI(expr1,expr2)
expr1 identifies the PID of the target job. If expr1 is an empty string (""), $ZGETJPI() returns information about the current process.
expr2 specifies the item keyword identifying the type of information returned; keywords may be upper, lower, or mixed-case. The keywords are as follows:
ZGETJPI()
Keywords
Data returned
ISPROCALIVE
Determines whether the specified process is alive.
CPUTIM
Total process and child CPU time used in hundredths of a second.
CSTIME
System time of child processes
CUTIME
User time of child processes
STIME
Process system time
UTIME
Process user time
Note that the $ZGETJPI() retrieves process time measurements (CPUTIM, CSTIME, CUTIME, STIME, and UTIME) only of the current process ($JOB). The "child" process time includes ZSYSTEM and PIPE device sub-processes (only after the PIPE CLOSEs), but excludes processes created by the JOB command.
$ZGETJPI() provides a tool for examining the characteristics of a UNIX process. Accessing information about processes belonging to other users requires certain UNIX privileges. Consult your system manager if you require additional privileges.
Example:
GTM>write $zgetjpi(1975,"isprocalive") 1 GTM>
This uses $ZGETJPI() to determine whether process 1975 is alive.
Example:
GTM>set t=$zgetjpi("","cputim")
GTM>do ^bench write $zgetjpi("","cputim")-t
1738
GTM>This uses $ZGETJPI() to measure the actual CPU time, measured in hundredths of a second, consumed by running the ^bench routine.
