Guardian Procedure Calls Reference Manual

and Value Representations (page 1019) for details on the attribute format. The attributes you can
specify are described in Table 34 (page 1020).
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. For details, see 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 followed by an unused byte whose value is indeterminate.
If srch-option indicates that information can be returned for multiple processes, the
ret-values-list might contain information for more than one process. The second process'
information starts at the first word boundary following the last item of the first process'
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 do not 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.
Whenever srch-option is 1 or 2, the caller must 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 Returned Value (page 1017).
PROCESS_GETINFOLIST_ Procedure 1015