TACL Reference Manual

UTILS:TACL Commands and Functions
HP NonStop TACL Reference Manual—429513-018
8-252
VINSERT Command
VINSERT Command
Use the VINSERT command to insert lines from the current TACL IN file into a given
line position in a variable.
variable-level
is an existing variable level into which lines are to be inserted. It must not be in a
shared segment, and must not be a DIRECTORY, a STRUCT, or a STRUCT item.
line-num
specifies the line number at which lines are to be inserted. It can be any of these:
F
L
number
F
specifies the first line in the variable level.
L
specifies a new line past the last line in the variable level.
number
is an integer identifying a specific line. It must be greater than zero and not
greater than the number of lines in the variable level, plus one (it can specify a
new line past the last existing line).
Considerations
•
Inserted lines are placed just before the line specified by line-num.
•
If the input text contains TACL metacharacters, the setting of the #INFORMAT
built-in variable (for input to the IN file, including input to an interactive TACL
process) or the ?FORMAT Directive on page 5-6 (for text in TACL programs) can
affect how TACL interprets the string. For more information, see the #INFORMAT
Built-In Variable on page 9-197 or the ?FORMAT directive.
Example
If the variable VAR has the contents shown:
THE QUICK BROWN
FOX JUMPED OVER
THE LAZY DOG
VINSERT variable-level line-num