Guardian Procedure Calls Reference Manual

srch-option
input
INT:value
has one of these values:
Return information for only the process specified by [nodename,] cpu,pin or by processhandle.
You cannot specify oss-pid with this value. These parameters are ignored when srch-option is set
to 0: srch-attr-list, srch-attr-count, srch-values-list, and srch-values-len.
0
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.
1
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.
2
Return information for only the OSS process specified by [nodename,] oss-pid. You cannot specify
processhandle or cpu,pin with this value. These parameters are ignored when srch-option is
set to 3: srch-attr-list, srch-attr-count, srch-values-list, and srch-values-len.
3
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 returned, the value of error-detail is 0 and
the value of pin, if specified, is -1; the values of all other output parameters are indeterminate.
srch-attr-list
input
INT .EXT:ref:*
is an array of integer attribute codes specifying the items that are included in the search criteria.
This parameter must be supplied if srch-option is 1 or 2. This parameter is ignored if
srch-option is 0 or 3. For the list of valid codes, see Attribute Codes and Value
Representations (page 1019).
srch-attr-count
input
INT:value
is the number of entries in srch-attr-list. This parameter must be supplied if srch-option
is 1 or 2. This parameter is ignored if srch-option is 0 or 3.
srch-values-list
input
INT .EXT:ref:*
is a list of the match values for the attributes in srch-attr-list. Its order must exactly
parallel the order of the attribute codes. The value representations are described under Attribute
Codes and Value Representations (page 1019). Each value begins on a word boundary. A
variable-length string, such as a file name, is represented by an INT value giving the byte length
of the string followed by the actual string. If a string is an odd number of bytes in length, it is
padded with an extra byte whose value is indeterminate.
This parameter must be present if srch-option is 1 or 2. This parameter is ignored if
srch-option is 0 or 3.
1016 Guardian Procedure Calls (P)