Guardian Procedure Calls Reference Manual

DEFINESETATTR Procedure
Summary
Syntax for C Programmers
Syntax for TAL Programmers
Parameters
Returned Value
Considerations
Example
Related Programming Manual
Summary
The DEFINESETATTR 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
#include <cextdecs(DEFINESETATTR)>
short DEFINESETATTR ( const char *attribute-name
,[ const char *value ]
,[ short value-len ]
,[ short _near *default-names ] );
Syntax for TAL Programmers
error := DEFINESETATTR ( attribute-name ! i
,[ value ] ! i
,[ value-len ] ! i
,[ default-names ] ); ! i
Parameters
attribute-name
input
STRING .EXT:ref:16
uniquely identifies an attribute. The name should be left justified and blank-filled.
value
input
STRING .EXT:ref:*
is the address of the array that contains the attribute value as an ASCII string (see Appendix E:
DEFINEs).
If this parameter is absent, the reset operation is assumed (the attribute is given a default value,
if one exists; else the attribute is deleted).
If this parameter is present, then the next parameter must be present.
DEFINESETATTR Procedure 289