Guardian Procedure Calls Reference Manual

value-len
input
INT:value
is the length (in bytes) of the array value. If -1, the value of the attribute is reset; the attribute
is given a default value, if it has one, or the attribute is deleted.
default-names
input
INT:ref:8
contains the default volume and subvolume names to be used to convert from the external
representation of the value to an internal representation.
Default volume name. First two bytes can be "\sysnum," in which case "$" is omitted from volume name
(blank-filled on right).
[0:3]
Default subvolume name (blank-filled on right).[4:7]
Returned Value
INT
Outcome of the call:
Success.0
A syntax error occurred in name.2049
Unable to obtain file-system buffer space.2052
Attribute not supported.2055
Attribute name too long.2062
A syntax error occurred in default names.2063
The required attribute cannot be reset.2064
Missing parameter.2066
Invalid value.2067
For other error values associated with DEFINEs, see the Guardian Procedure Errors and Messages
Manual.
Considerations
• To reset an attribute, either the value parameter can be omitted, or value-len can be -1.
• "Required" attributes cannot be reset. (See the TACL Reference Manual.)
• If an error occurs, the contents of the working set are not modified.
• The form of value, with respect to quotes, depends on the attribute. The use of quotes should
be avoided.
Quotes can be used with the FILEID, MOUNTMSG, and OWNER attributes. Quotes are
discarded from the beginning and end of the string.
Text not enclosed in quotes requires only one quote for a quote mark; text delimited by quotes
needs two quotes for a quote mark. The leading and trailing quotes do not count toward the
length of the attribute.
• A list of values must have the values separated by commas and must be enclosed in
parentheses.
• When CLASS attribute is set (even if the value is not changed), the working set is reinitialized
with the attributes of the new class and their default values.
290 Guardian Procedure Calls (D-E)