Guardian Procedure Calls Reference Manual (G06.25+)

Guardian Procedure Calls (P)
Guardian Procedure Calls Reference Manual—522629-013
12-227
PROCESSINFO Procedure
(Superseded by PROCESS_GETINFOLIST_
Parameters
error returned value
INT
returns a value indicating the outcome of the call.
0 Status for process
cpu,pin is returned.
1 Process
cpu,pin does not exist or does not match specified criteria (see
search-mode). Status for next higher cpu,pin in the specified
processor is returned. The 4-word process ID of the process for which
status is being returned is returned, in the
process-id parameter (if
present).
2 Process
cpu,pin does not exist, and no higher cpu,pin in the
specified processor that matches the specified criteria exists (see
search-mode).
3 Unable to communicate with
cpu.
5 The system specified by
sysnum could not be accessed.
6 Internal error.
7 Unable to process the D-series file name.
99 Parameter error.
cpu,pin input
INT:value
is the processor number (processor in bits <4:7> with <0:3> set to 0) and PIN (bits
<8:15>) number of the process whose status is being requested. The process
identification number (PIN) is a number used to uniquely identify the process
control block (PCB) in a processor for a process.
process-id input, output
INT:ref:4
is an array where PROCESSINFO returns the 4-word process ID of the process
whose status is actually being returned. This can be different from the process
whose status is requested through cpu,pin (see the error parameter).
On input, the
process-id contents can be used as a search criterion (see the
search-mode parameter).