IBM Tivoli NetView for z/OS Programming: Pipes - IBM notice

is searched. If you do not specify a position.length, the entire line is searched.
For the with specifications as arguments format only, you can specify the letter S
for the length if the specification is followed by a delimited string. When this
is done, the CHANGE stage replaces the letter S with the length of that
delimited string.
R Specifies that the case of string1 is to be respected. This parameter is only valid
for the with parameters from secondary input format, and is the default. For the
with specifications as arguments format, case is respected.
I Specifies that the case of string1 is to be ignored. This parameter is only valid
for the with parameters from secondary input format. For the with specifications as
arguments format, specify the CHANGE stage on the CASEI stage.
string1
The character string to be replaced in input lines.
string2
The character string to replace string1.
Usage Notes
The CHANGE stage cannot be a first stage.
Examples
Example: Changing All Occurrences of a String
The following example changes all occurrences of 'AAA' to 'ZZ'.
PIPE LITERAL /AAABBBAAA/
| CHANGE /AAA/ZZ/
| CONSOLE
The following output is produced:
ZZBBBZZ
Example: Inserting Constants
The following example inserts a constant at the start of each line.
PIPE NETV DISCONID
| CHANGE //DISCONID: /
| CONSOLE
Output similar to the following output is produced:
DISCONID: CNM492I OPERATOR ID CONSOLE ID CONSOLE NAME
DISCONID: CNM492I ----------- ---------- ------------
DISCONID: CNM492I NTVF0PPT EXTENDED NTVFTF0
DISCONID: CNM492I AUTOAON EXTENDED AUTONF0
DISCONID: CNM492I END DISPLAY
Example: Using CHANGE with CASEI Stage
Starting from column 2, the following example changes up to 4 occurrences of 'A'
or 'a' to 'Zz'.
NETVASIS PIPE LITERAL /AaBbAaCcAa/
| CASEI CHANGE 2.* /a/Zz/ 4
| CONSOLE
The following output is produced:
AZzBbZzZzCcZza
PIPE CHANGE
Chapter 2. Pipeline Stages and Syntax 35