Guardian Procedure Calls Reference Manual (G06.25+)

Guardian Procedure Calls (D-E)
Guardian Procedure Calls Reference Manual—522629-013
4-45
DEFINESETATTR Procedure
DEFINESETATTR Procedure
Summary
Syntax for C Programmers
Syntax for TAL Programmers
Parameters
Considerations
Example
Related Programming Manual
Summary
This procedure allows the caller to modify the value of an attribute in the working set.
The value is supplied in ASCII string form. It is validated, converted into the internal
representation and established as the value for the attribute. If the value is a file name
or a subvolume name, the default volume information is used to convert the value into
the internal form.
This procedure can also be used to reset the value of an attribute to its default value, if
one exists, or to delete the attribute from the working set. The attributes of the different
DEFINE classes are described in Appendix E, DEFINEs
.
Syntax for C Programmers
Syntax for TAL Programmers
Parameters
error returned value
INT
indicates the outcome of the call:
0 Successful
2049 A syntax error occurred in name
#include <cextdecs(DEFINESETATTR)>
short DEFINESETATTR ( const char *attribute-name
,[ const char *value ]
,[ short value-len ]
,[ short _near *default-names ] );
error := DEFINESETATTR ( attribute-name ! i
,[ value ] ! i
,[ value-len ] ! i
,[ default-names ] ); ! i