TACL Reference Manual

UTILS:TACL Commands and Functions

HP NonStop TACL Reference Manual—429513-018

8-241

VCHANGE Command

Use the VCHANGE command to change all occurrences of one string to another string

in a range of lines within a variable.

option

is any of these:

OUT file-name

QUIET

TO variable-level

OUT file-name

specifies a device, or a sequential file accessible to the sequential I/O (SIO)

facility, that is to receive the changed lines. The listing includes line numbers. If

you omit this option, TACL writes the listing to its current OUT file. If the QUIET

option is present, this option is ignored.

If you specify an OUT file that does not exist, TACL creates an EDIT file

named list-file. If you specify an OUT file that already exists, TACL appends

the information to the end of the file.

QUIET

suppresses listing of changed lines, even if the OUT option is supplied.

TO variable-level

is the name of an existing variable level to which a listing of all changed lines is

to be appended. Line numbers are not included. The QUIET option has no

affect on this option.

variable-level

is the name of an existing variable level containing the lines to be changed. It must

not be in a shared segment, and must not be a DIRECTORY, a STRUCT, or a

STRUCT item.

string-1

is the string to be changed wherever it occurs in the specified range of lines. A

string is the name of a variable level, text enclosed in quotation marks, or a

concatenation of such entities. The concatenation operator is '+' (the apostrophes

are required).

VCHANGE [ / option [ , option ] ... / ] variable-level

string-1 string-2 [ range ]