Guardian Procedure Calls Reference Manual

Unable to communicate with cpu; cpu might not exist.5
Unable to communicate with nodename.6
No more matches exist; error-detail contains the number of processes for which information has been
returned (might be 0).
7
(reserved)8
Invalid search attribute code; error-detail contains the first code in question to be detected
(error-detail is not an index into a list).
9
Invalid search value; error-detail contains the associated attribute code (not an index into a list).10
Invalid return attribute code; error-detail contains the code in question (error-detail is not an index
into a list).
11
Invalid srch-option12
Invalid auxiliary data size specification in an attribute code; error-detailcontains the attribute code.14
An iterative attribute was not the last attribute in ret-attr-list; error-detail contains the attribute
code.
15
Attribute not permitted in a search request; error-detail contains the attribute code.16
Attribute restricted to privileged callers; error-detail contains the attribute code.17
Auxiliary Data
Certain attributes require auxiliary data that provides additional information about the attributes.
This auxiliary data is provided by the caller and immediately follows the attribute code in the
ret-attr-list array. The word containing the attribute code includes a field in which the caller
specifies the length of the auxiliary data (see Attribute Codes and Value Representations (page 1019)).
Note that if any auxiliary data is included in ret-attr-list, the ret-attr-count parameter
must include the word count for the auxiliary data.
Iterative Attributes
Iterative attributes are used to report information about multiple loadfiles. These attributes return a
variable length array describing object files loaded for the target process. The iterative attributes
perform an iterative query, in which multiple loadfiles are queried. Each iteration is an invocation
of PROCESS_GETINFOLIST_. Iteration is controlled by a 64-bit context value that is input as auxiliary
data in ret-attr-list and returned in ret-values-list.
To start an iterative query, the caller initially sets the context value to zero. When the query is
complete, that is, all loadfiles requested by the attribute have been reported, the returned context
value is zero.
A nonzero returned context value indicates that the returned information has exceeded the amount
of available space specified by ret-values-list and ret-values-maxlen. In this case, as
much information as will fit in the space is returned; the caller can then copy the returned context
value into the attribute's auxiliary data and call PROCESS_GETINFOLIST_ to continue iterating.
An iterative attribute must be the last one in the attribute list. If it is not, an error is reported. Iterative
attributes cannot be used with srch-option 1 or 2.
Loadfile Types
Several attributes return information about loadfiles, including the loadfile type. The loadfile type
is indicated by a code having one of the values shown in the table that follows.
The loadfile type constants are declared in DDL-based header files, including the ZSYSC section
process_getinfolist_return, with identifiers ZSYS_VAL_PINF_TYPE_suffix and the
1018 Guardian Procedure Calls (P)