TACL Reference Manual

Built-In Functions and Variables
HP NonStop TACL Reference Manual—429513-018
9-99
#DEFINEREADATTR Built-In Function
#DEFINEREADATTR Built-In Function
Use #DEFINEREADATTR to obtain the current value of a specified attribute in the
TACL context or in the working set. This function invokes the DEFINEREADATTR
operating system procedure.
define-name
is the name of the DEFINE in the TACL context from which an attribute is to be
read.
_
An underscore in place of define-name specifies that the attribute is to be read
from the current working set.
attribute-name
is the name of the attribute to be read.
cursor
is a numeric pointer to the attribute to be read; zero indicates the first attribute in
the DEFINE. You can use cursor, along with mode, in place of attribute-name
as an alternative method of attribute specification.
mode
is a numeric indicator used with cursor; it can be any of these:
Result
#DEFINEREADATTR returns a numeric error code indicating the outcome of the
DEFINEREADATTR procedure; zero indicates success. See Appendix B, Error
Messages for a list of DEFINE-oriented error codes.
If the error code is 0 or 2061 (no more attributes), the following are also included as a
space-separated list:
•
The cursor value for the next attribute in sequence, consistent with the mode
specification. This is zero if an attribute name, rather than a cursor, was supplied
as an argument.
#DEFINEREADATTR
{ define-name | _ }
{ attribute-name | cursor-mode }
0 Search only attributes that are present
1 Search present attributes, plus required attributes not present
2 Search present attributes, plus required and optional attributes not present