Guardian Procedure Calls Reference Manual (G06.25+)

Guardian Procedure Calls (P)
Guardian Procedure Calls Reference Manual—522629-013
12-75
PROCESS_GETINFOLIST_ Procedure
Whenever srch-option is 1 or 2, the caller should either include the PIN (38) or
OSS process ID (90) attribute in the set of requested attributes in order to identify
the Guardian or OSS process associated with each set of returned values.
ret-values-maxlen input
INT:value
is the maximum length in words of
ret-values-list. Valid values for the
ret-values-maxlen parameter are in the range 0 through 8192.
ret-values-len output
INT .EXT:ref:1
is the actual length in words of
ret-values-list.
error-detail output
INT .EXT:ref:1
for some returned errors, contains additional information. See
error, above.
srch-option input
INT:value
has one of the following values:
0 Return information for only the process specified by [
nodename,] cpu,pin or
by
processhandle. You cannot specify oss-pid with this value. The
following parameters are ignored when
srch-option is set to 0: srch-
attr-list, srch-attr-count, srch-values-list, and srch-
values-len.
1 Start a search at
[nodename,] cpu,pin and return information for the first
matching process. You cannot specify
processhandle or oss-pid with
this value.
2 Start a search at
[nodename,] cpu,pin and return information for as many
matching processes as will fit in
ret-values-list. You cannot specify
processhandle or oss-pid with this value.
3 Return information for only the OSS process specified by
[nodename,] oss-pid. You cannot specify processhandle or
cpu,pin with this value. The following parameters are ignored when srch-
option is set to 3: srch-attr-list, srch-attr-count, srch-
values-list, and srch-values-len.
The default is 0.
If you specify a value of 1 or 2 and an
error of 0 or 4 is returned, information has
been returned for at least one process.
If you specify a value of 1 or 2 and an
error of 7 (no more matches) is returned,
the search is complete; the value of
error-detail indicates whether any
process information has been returned. If no process information has been