Guardian Procedure Calls Reference Manual

DEFINEREADATTR Procedure
Summary
Syntax for C Programmers
Syntax for TAL Programmers
Parameters
Returned Value
Considerations
Example
Summary
The DEFINEREADATTR procedure allows the caller to obtain the current value of an attribute in a
DEFINE in the calling process' context or in the working set. The value of a specific attribute can
be read or all the attributes can be sequentially read. The value is returned in an ASCII string form
suitable for display.
Syntax for C Programmers
#include <cextdecs(DEFINEREADATTR)>
short DEFINEREADATTR ( [ const char *define-name ]
,char *attribute-name
,[ short _near *cursor ]
,char *value-buf
,short value-buf-len
,short _near *value-len
,[ short read-mode ]
,[ short _near *info-word ] );
Syntax for TAL Programmers
error := DEFINEREADATTR ( [ define-name ] ! i
,attribute-name ! i,o
,[ cursor ] ! i,o
,value-buf ! o
,value-buf-len ! i
,value-len ! o
,[ read-mode ] ! i
,[ info-word ] ); ! o
Parameters
define-name
input
STRING .EXT:ref:24
is the 24-byte array that contains the name of the DEFINE for the procedure to use. The name
is left-justified and padded on the right with blanks. Trailing blanks are ignored.
Omit this parameter to refer to the working set.
attribute-name
input, output
STRING .EXT:ref:16
If cursor is absent, then this parameter names the attribute whose value is to be returned.
DEFINEREADATTR Procedure 277