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

PIPE LOOKUP
Syntax
LOOKUP:
►
LOOKUP
1.*
detail_position.length reference_position.length
APPEND WILDCARD /xyz/
Command Description
The LOOKUP stage compares two input streams and indicates on its output
streams whether a match was found.
Streams
Data is read from the secondary input stream until it disconnects. The records read
on the secondary input stream are called reference records. The data supplied on
the primary input stream is compared to these reference records.
After the secondary input stream disconnects, data is read from the primary input
stream. The records read on the primary input stream are called detail records.
Each detail record is compared to the reference records. If the detail record matches
a reference record, the input message containing the detail record is written to the
primary output stream. Otherwise, it is written to the secondary output stream.
The detail record data stream is not delayed.
If the detail record is a multiline message, only the first line of the message is
compared to the reference records. If a match is found, the entire multiline
message is written to the primary output stream. If a match is not found, the entire
multiline message is written to the secondary output stream.
When all detail records have been processed and the primary input stream
disconnects, LOOKUP writes all reference records that were not matched to any
detail record to the third output stream.
One use for LOOKUP is to compare a new data stream to an old data stream to
determine added, deleted, or unchanged lines.
Stream Type Number Supported
Input 2
Output 3
Termination Conditions
LOOKUP ends when all input and output streams are disconnected.
PIPE LOOKUP
Chapter 2. Pipeline Stages and Syntax 159
►