Guardian Procedure Calls Reference Manual (G06.25+)

Guardian Procedure Calls (D-E)
Guardian Procedure Calls Reference Manual—522629-013
4-47
DEFINESETATTR Procedure
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
re-initialized with the attributes of the new class and their default values.
•
attribute-name should not be declared as a P-relative array. In general, a
reference parameter should not be declared as a P-relative array.
Example
STRING .EXT labelprocessing [0:15]; ! attribute name
STRING .EXT value [0:15]; ! attribute value
INT .default^names [0:7];
LITERAL value^len = 6; ! attribute value length
.
.
default^names ':=' ["$VOL MYSUBVOL"];
labelprocessing ':=' ["labels "];
value ':=' ["bypass"];
error := DEFINESETATTR( labelprocessing, value,
value^len, default^names );
IF error <> DEOK THEN ...
Related Programming Manual
For programming information about the DEFINESETATTR procedure, refer to the
Guardian Programmer’s Guide.