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

Introduction and Concepts
8 Programming: Pipes
PIPE (END %)
< NAMES
| A: LOCATE /BOB/
| CHANGE //HERE IS A NAME CONTAINING ’BOB’ ==>/
| CONSOLE
%A:
| CONSOLE
The < (From Disk) stage reads data from a file called NAMES, containing three
names. The three names are:
v BOB SMITH
v FRED FORD
v MARY BOBBIT
The selected data is written to the console using the CONSOLE stage. All records
containing the string BOB will be prefixed with the string HERE IS A NAME
CONTAINING ’BOB’ ==>.
In this example, the string BOB is located in the input data. Label A: was defined on
the LOCATE stage; data that does not contain the string BOB will be passed as an
input stream to the stage following the stage labeled A:. The end of the simple
pipeline and the beginning of the second is indicated by the end character, which
is defined as a % symbol in (END %).
This complex pipeline is logically made up of the following parts:
v The definition of the end character that is to be used to separate the different
simple pipelines.
PIPE (END %)
v The first simple pipeline. The LOCATE stage, which generates multiple output
streams, is labeled with an A: indicating that data not selected by the LOCATE
stage will be passed to the connector A: later in the pipeline specification.
< NAMES
| A: LOCATE /BOB/
| CHANGE //HERE IS A NAME CONTAINING ’BOB’ ==>/
| CONSOLE
v The end character indicates the end of the first simple pipeline and the
beginning of the second simple pipeline.
%
v The next occurrence of label A: is as a connector that connects the secondary
output of LOCATE /BOB/ as an input stream to CONSOLE in the second simple
pipeline. This A: is a connector and not a label definition because this A: is not
included in a stage.
A:
v The second simple pipeline that will handle the data not selected by LOCATE
/BOB/.
| CONSOLE
The resulting output of this complex pipeline is shown in Figure 10 on page 9.