TACL Reference Manual

Built-In Functions and Variables
HP NonStop TACL Reference Manual—429513-018
9-246
#LOAD Built-In Function
#LOAD Built-In Function
Use #LOAD to load variables from a TACL library file into memory. A library file
consists of one or more ?SECTION directives of the form:
?SECTION name type
Each directive is followed by one or more lines of text that are to be associated with the
variable level specified by name. The nature of the text is largely dependent on the
type of the section, which can be ALIAS, DELTA, MACRO, ROUTINE, STRUCT, or
TEXT. The body of text ends with the next ?SECTION directive, or the end of the file,
whichever comes first.
option
can be either of these:
KEEP num
causes TACL to perform an implicit KEEP num command on each variable it
loads.
LOADED variable-level
causes the list of variables loaded to be placed in variable-level rather
than in the result of #LOAD; variable-level must already exist. Its original
contents are lost and its type is set to TEXT. variable-level contains one
variable name per line, so it is suitable for processing by #EXTRACT(V).
file-name
is the name of a TACL library file.
Result
#LOAD returns a space-separated list containing the names of the variables loaded. If
you specify the LOADED option, however, #LOAD returns nothing.
Considerations
•
The LOADED option is especially useful for loading libraries containing large
numbers of variables (so many that a “text buffer overflow” error results when they
are placed in the result of #LOAD).
•
If you need to include a blank line (often useful in DELTA type variables), use the
?BLANK directive. ?BLANK causes the loader to insert a blank line in the variable
level.
#LOAD [ / option [ , option ] / ] file-name