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

PIPE Command
went in, but only two came out. Without knowing exactly what stage was in effect,
we cannot say for sure what happened to the third message, but we do know that
such disappearances can be legitimate.
Figure 3 shows a more explicit example. In this case, the stage specification is:
LOCATE /BOB/
LOCATE is a stage and its purpose here is to locate every occurrence of the string
BOB in the data passing through the stage. Here, we see three messages flow into
the stage. LOCATE looks at the content of each incoming message. If the incoming
message contains the string BOB, the message remains in the pipeline. Otherwise,
the message is removed from the pipeline.
Input Messages Output Messages
Bob Smith
Fred Ford
Mary Bobbit
Locate /Bob/
Stage
Fred
Ford
Bit
Bucket
You can issue the NetView PIPE command anywhere you use a NetView regular
(Type=R) command:
v The NetView command line
v A NetView command list
v A REXX command list
v A high-level-language command procedure such as PL/I or C
v An environment that allows timer commands.
In a PIPE command, stages are separated by a character called a stage separator.
PIPE STAGE1 | STAGE2 | ... | STAGEn
Bob Smith
Mary Bobbit
Figure 3. Messages Flowing through a LOCATE Stage
Introduction and Concepts
A stage separator placed before the first stage or after the last stage is optional.
The default stage separator is the character X'4F'. Depending on your workstation,
this stage separator is either a solid vertical bar (|) or a split vertical bar (¦).
PIPE commands can be shown in two ways: the portrait format or the landscape
format. In portrait format, parameters are stacked vertically in the manner shown
in Figure 4 on page 4. In landscape format, parameters are strung horizontally as
shown in Figure 5 on page 4. When entering a PIPE command from the command
line, you might prefer landscape form. When issuing a PIPE command from a
command procedure, you might prefer the portrait form. Either form, or any
combination of the two, is valid.
Chapter 1. NetView Pipelines Introduction and General Concepts 3