Guardian Procedure Calls Reference Manual (G06.25+)

Guardian Procedure Calls (D-E)

Guardian Procedure Calls Reference Manual—522629-013

4-32

DEFINEREADATTR Procedure

Summary

Syntax for C Programmers

Syntax for TAL Programmers

Parameters

Considerations

Example

Summary

This procedure allows the caller to obtain the current value of an attribute in a DEFINE

in the calling process’s 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

Syntax for TAL 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 ] );

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