Guardian Procedure Calls Reference Manual (G06.25+)

Guardian Procedure Calls (D-E)
Guardian Procedure Calls Reference Manual—522629-013
4-33
DEFINEREADATTR Procedure
Parameters
error returned value
INT
indicates the outcome of the call:
0 Successful
2049 A syntax error occurred in name
2051 DEFINE not found
2052 An error occurred when placing PFS in use
2054 Bounds error on parameter
2055 Attribute not supported
2061 No more attributes (see “Considerations”)
2066 Missing parameter
For other error values associated with DEFINEs, refer to the
Guardian Procedure
Errors and Messages Manual.
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.
If
cursor is present, then this is an output parameter. The name is left-justified
and blank-filled on output.
cursor input, output
INT:ref:1
is a pointer to the attribute on input. On output,
cursor points to the sequentially
next attribute that is to be read. To read the first attribute, set the
cursor to 0.
To sequentially read all attributes, do not modify this parameter.
If both
attribute-name and cursor are present, then cursor is used to
identify the attribute.