TACL Reference Manual

Built-In Functions and Variables
HP NonStop TACL Reference Manual429513-018
9-316
#PUSH Built-In Function
#PUSH Built-In Function
Use #PUSH to create a new top-level definition for one or more variables or built-in
variables.
variable
is a valid variable name or a built-in variable name.
Result
#PUSH returns nothing.
Considerations
The PUSH command is an alias for the #PUSH built-in function and can be used
interchangeably with it.
For variables, #PUSH creates an empty top level of type TEXT.
For built-in variables, #PUSH creates a new top-level definition, copying the old
top-level definition to the new one (top-level and second-level definitions are now
the same).
If the variable does not exist, PUSH registers the name of the variable, but does
not allocate space until you use #SET or a similar command or built-in function to
actually place data into the variable. As a result, you must perform a SET
VARIABLE or related operation prior to using the variable in an #IF call or other
command or function that tests the value of the variable.
Do not try to #PUSH the root directory (:). If you try this, TACL returns "*ERROR*
Cannot push or pop the root segment's root."
To avoid losing standard functionality from your TACL environment, do not #PUSH
directories supplied as part of the TACL product (such as UTILS).
#PUSH variable [ [,] variable ] ...