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

PIPE NOT
Syntax
NOT:
NOT stage_specification
Command Description
The NOT stage changes the way output is passed to the primary and secondary
output streams for those stages that pass part of their output to the primary output
stream and part of their output to the secondary output stream. Such stages are
called “selection stages” and examples are CHOP, TAKE, TOSTRING, and
LOCATE. NOT causes the specified stage to execute as usual, except that input
usually passed to the secondary output stream is passed to the primary output
stream and the input usually passed to the primary output stream is passed to the
secondary output stream. For example, specifying NOT TOSTRING /ABC/ passes
all input up to, and including, the first message containing ABC to the secondary
output stream, and passes all subsequent input to the primary output stream.
Termination Conditions
The NOT stage modifies the stage specified in stage_specification. Because it is a
modifier stage, NOT does not have its own termination conditions. See the
information on the stage NOT is modifying for termination conditions.
Operand Descriptions
Usage Notes
Examples
stage_specification
The stage specification being modified, including its operands.
v The NOT stage does not invert the function of the specified stage. NOT
SEPARATE does not become COLLECT. NOT SEPARATE discards all input,
because SEPARATE keeps all input.
v The STRIP stage is not considered a selection stage. NOT STRIP discards all
input.
v The stage NOT CHOP chop-operands keeps the part of each line that CHOP
usually passes to the secondary output stream, if connected.
v Be careful in considering the inversion of output for stage options. For example,
when the NOINCL (no include) option is used with TOSTRING, the TOSTRING
stage passes the message containing the matching string to the secondary output
stream. If NOT is used with TOSTRING NOINCL, the matching message is
passed to the primary output stream.
v NOT is only supported for stages with two output streams.
Example: Passing Messages After One Containing a Certain
String
The following example displays all data that follows the separator line, where
TOSTRING normally stops.
PIPE NOT
Chapter 2. Pipeline Stages and Syntax 175