Guardian Procedure Calls Reference Manual (G06.25+)

Guardian Procedure Calls (D-E)
Guardian Procedure Calls Reference Manual—522629-013
4-34
DEFINEREADATTR Procedure
value-buf output
STRING .EXT:ref:*
is the data array provided by the calling program to return the value of the attribute.
The value is in external form, suitable for display. If the value is a file name, it is
fully qualified.
value-buf-len input
INT:value
is the length of the array
value-buf in bytes.
value-len output
INT:ref:1
gives the actual size of the external representation for the value. If greater than
value-buf-len, then only value-buf-len bytes have been transferred and
truncation has occurred. An absent attribute is indicated by a length of -1.
read-mode input
INT:value
is used with
cursor. It indicates the search mode for the next parameter whose
cursor value is to be returned.
0 Search present attributes only.
1 Search present plus required attributes that are not present.
2 Search present plus required and optional attributes that are not present.
If
read-mode is not supplied, 0 is used.
info-word output
INT:ref:1
info-word.<14:15> indicates the type of the attribute:
0 optional
1 defaulted
2 required
info-word.<13> is set if this attribute was involved in an inconsistency at the last
check. (See DEFINEADD parameter
checknum for a list of DEFINE consistency
check numbers.)
Considerations
•
This procedure can be used to obtain the value of any attribute in the DEFINE
working set, including the CLASS attribute.