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

Chapter 4. NetView Pipeline Filters
This chapter describes general-use programming interface and associated guidance
information. For information about using pipelines in high-level languages, see
IBM Tivoli NetView for z/OS Programming: PL/I and C.
A filter is a stage that reads messages from its input stream, manipulates them,
and writes the results to its output stream. One common use of a filter is to select
or discard messages based on some search or positional criteria. The difference
between a filter and a device driver is that a filter does not interact with devices or
other system resources, as device drivers do.
The output stream from a filter stage can be far different from the data read from
the input stream. By stringing filters together, you can transform raw data into
useful results.
This chapter describes filters that:
v Manipulate messages
v Select messages by content
v Select messages by position
v Discard messages from the pipeline
Manipulating Messages: SEPARATE, COLLECT
NetView Pipelines includes stages that can modify messages in the pipeline.
You can:
v Separate multiline messages into multiple single-line messages (SEPARATE)
v Collect multiple single-line messages into a multiline message (COLLECT).
Breaking Up an MLWTO: SEPARATE
The SEPARATE stage allows the user to break a multiline write-to-operator
(MLWTO) message into single-line messages, each of which inherits the attributes
of the MLWTO.
Example: Separating an MLWTO into Single-line Messages
This example shows how to use the SEPARATE stage to break the MLWTO created
by the NETVIEW stage into single-line messages:
PIPE NETVIEW MVS D A,L | CORRWAIT 20 | SEPARATE | CONSOLE
Output from the pipeline looks similar to:
© Copyright IBM Corp. 1997, 2011 303