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

PIPE FANIN
Syntax
FANIN:
FANIN
Command Description
The FANIN stage reads from multiple input streams. Unlike FANINANY, which
reads multiple input streams simultaneously, FANIN reads from the first stream
until that stream disconnects. FANIN then reads from the next input stream until it
disconnects and so on. All data read by FANIN is passed to a single output stream.
Streams
Stream Type Number Supported
Input 10
Output 1
Termination Conditions
FANIN terminates when all input streams disconnect or the output stream
disconnects.
Operand Descriptions
This stage has no operands.
Usage Notes
Examples
PIPE FANIN
v The primary input stream is the first to be processed. Additional input streams
are delayed until processing is completed for the primary input stream.
v FANIN enables you to write output to a single stem variable from multiple
places within a single pipeline.
Example: Process a List of Names
In this example, a list of names is read from a data set member. All individuals
with the name SMITH are checked for the name TOMMY. All names containing
SMITH and TOMMY result in TOMMY being changed to TOM. Because the
processing of records containing SMITH is the primary input to FANIN, all records
containing SMITH are placed in the NAMES. stem, first.
Next, all records containing BAKER are truncated after 22 characters. The
truncated records are input to FANIN and subsequently placed in the NAMES.
stem.
Finally, all other names that are not SMITH or BAKER are processed by FANIN
and placed in the NAMES. stem.
Chapter 2. Pipeline Stages and Syntax 125