Guardian Procedure Calls Reference Manual

srch-values-len
input
INT:value
if present, is the length in words of srch-values-list.
This parameter must be present if srch-option is 1 or 2. This parameter is ignored if
srch-option is 0 or 3.
oss-pid
input
INT(32):value
if present and not null, contains the OSS process ID of the OSS process of interest. A null OSS
process ID is obtained by calling the OSS_PID_NULL_ procedure. nodename:length must
be specified when the caller wants information about an OSS process on a remote node. The
attributes OSS controlling terminal (27) and OSS program pathname (93) are valid only on
the local node.
If a value is supplied for oss-pid, srch-option must be 3, processhandle must be
omitted or null (-1 in each word), and cpu and pin must be omitted or -1. This parameter is
ignored if srch-option is 0, 1, or 2.
timeout
input
INT(32):value
if present and not greater than zero, specifies how many hundredths of a second the process
waits to get the process information; otherwise timeout defaults as follows:
• for information about a process on the local node: none (wait forever)
• for information about a process on a remote node: 60 second (see note)
The maximum value is 2147483647. This parameter is supported on systems running H06.26
and later H-series RVUs and J06.15 and later J-series RVUs; on earlier RVUs, the default timeout
is used.
NOTE: The default behavior changed in the H06.22 and J06.11 RVUs. Previously, the
procedure waited forever on remote nodes as well as the local node. The change is also
included in the following T9050 SPRs and those that supersede them: AUR, AUS, AUT, AUU;
one of these is applicable to each of RVUs H06.15-21 and J06.04-10.
Returned Value
INT
Outcome of the call:
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).
0
File-system error; error-detail contains the error number.1
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.
2
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.
3
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
4
of processes for which information has been returned (might be more than one process if in search mode). If
no search criteria were specified, no information was returned and error-detail contains 0.
PROCESS_GETINFOLIST_ Procedure 1017