Guardian Procedure Calls Reference Manual (G06.25+)

Guardian Procedure Calls (P)
Guardian Procedure Calls Reference Manual—522629-013
12-74
PROCESS_GETINFOLIST_ Procedure
processhandle input
INT .EXT:ref:10
if present and not null (-1 in each word), is an input parameter specifying the
process handle of the process of interest.
If a value is supplied for
processhandle, then srch-option must be omitted or
0,
nodename:length must be omitted or length must be 0, cpu and pin must
be omitted or -1, and
oss-pid must be omitted or null (a null OSS process ID is
obtained by calling the OSS_PID_NULL_ procedure).
ret-attr-list input
INT .EXT:ref:*
is an array of INTs indicating the attributes, and any auxiliary data supplied with
auxilary data attributes, that are to have their values returned in
ret-values-list. See Attribute Codes and Value Representations on
page 12-79 for details on the attribute format. The attributes you can specify are
described in Table 12-2
.
ret-attr-count input
INT:value
indicates the number of 16-bit words the caller is supplying in
ret-attr-list.
This number includes the attribute count and the word count for any auxiliary data
supplied with auxiliary data attributes. Valid values for the
ret-attr-count
parameter are in the range 0 through 1024.
ret-values-list output
INT .EXT:ref:*
contains
ret-values-len words of returned information. The values parallel the
items in
ret-attr-list. See “Attribute Codes and Value Representation,” later
in this subsection, for details. 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 followed by an unused byte whose value is
indeterminate.
If
srch-option indicates that information can be returned for multiple processes,
then the
ret-values-list might contain information for more than one process.
The second process’s information starts at the first word boundary following the
last item of the first process’s information. The procedure returns as many
complete sets of values as will fit in the buffer; it does not return one or more
complete sets plus a partial set.
If the return values don’t fit in
ret-values-list, the procedure returns an
error of 1 and an error-detail value of 563 (buffer too small); no process
information is returned.