Guardian Procedure Calls Reference Manual (G06.25+)

Guardian Procedure Calls (P)
Guardian Procedure Calls Reference Manual—522629-013
12-71
PROCESS_GETINFOLIST_ Procedure
•
The parameter length specifies the length in bytes of the character string pointed
to by
nodename. The parameters nodename and length must either both be
supplied or both be absent.
Syntax for TAL Programmers
Parameters
error returned value
INT
indicates the outcome of the operation. It returns one of the following values:
0 Information is returned for the specified process or processes;
error-
detail
contains the number of processes for which information has been
returned (might be more than one process if in search mode).
1 File-system error;
error-detail contains the error number.
2 Parameter error;
error-detail contains the number of the first parameter
found to be in error, where 1 designates the first parameter on the left.
Note
that parameters are counted as in TAL; thus, nodename:length are
considered together as number 3, and processhandle is number 4.
3 Bounds error; error-detail contains the number of the first parameter
found to be in error, where 1 designates the first parameter on the left.
4 Specified process does not exist or does not meet search criteria. If search
criteria were specified, the information returned is for a process (or processes)
with a higher PIN;
error-detail contains the number of processes for
error := PROCESS_GETINFOLIST_ ( [ cpu ] ! i 1 !
,[ pin ] ! i,o 2 !
,[ nodename: length ] ! i:i 3!
,[ processhandle ] ! i 4!
, ret-attr-list ! i 5!
, ret-attr-count ! i 6!
, ret-values-list ! o 7!
, ret-values-maxlen ! i 8!
, ret-values-len ! o 9!
,[ error-detail ] ! o 10!
,[ srch-option ] ! i 11!
,[ srch-attr-list ] ! i 12!
,[ srch-attr-count ] ! i 13!
,[ srch-values-list ] ! i 14!
,[ srch-values-len ] ! i 15!
,[ oss-pid ] ); ! i 16 !