Guardian Procedure Calls Reference Manual (G06.25+)

Guardian Procedure Calls (P)
Guardian Procedure Calls Reference Manual—522629-013
12-229
PROCESSINFO Procedure
(Superseded by PROCESS_GETINFOLIST_
home-terminal input, output
INT:ref:12
is an array where PROCESSINFO returns the internal-format device name of the
process-id’s home terminal.
On input, the
home-terminal contents can be used as a search criterion (see the
search-mode parameter).
sysnum input
INT:value
specifies the system (in a network) where the process for which information is to
be returned is running. If this parameter is omitted, the local system is assumed.
search-mode input
INT:value
is a bit mask that specifies one or more “search” conditions.
The input values of certain parameters to PROCESSINFO are used as the search
conditions; information is returned for the first process that matches the conditions.
The search is conducted on the processor specified in
cpu,pin. The specified
PIN is searched first and if it does not match the conditions, the higher PINs are
progressively searched.
The bit fields in
search-mode specify the conditions being searched for:
<0> = 1 must match process-id for 3 words
= 0 no search
<1> = 1 must match creator-access-id
= 0 no search
<2> = 1 must match process-access-id
= 0 no search
<3> = 1 must be <= priority
= 0 no search
<4> = 1 must match program-filename
= 0 no search
<5> = 1 must match home-terminal
= 0 no search
<6> = 1 must match jobid
= 0 no search
If multiple search conditions are specified, then all must be met.
If
search-mode is omitted, the default value is 0.