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

PIPE DIVERT
Syntax
DIVERT:
DIVERT
COLLECT
Command Description
The DIVERT stage writes messages received on its primary input to either its
primary output or its secondary output, depending on what is received on its
other input streams. When a message is available on the secondary input, the
message from the primary input is written to the primary output. Otherwise, when
a message is available on the tertiary input, the message from the primary input is
written to the secondary output. Any message read from the secondary or tertiary
input is discarded, unless COLLECT is specified.
Streams
Stream Type Number Supported
Input 3
Output 2
Termination Conditions
DIVERT terminates when any of the following conditions occur:
v When its primary input becomes disconnected.
v When both its secondary and tertiary inputs become disconnected.
v When both its primary and secondary outputs become disconnected.
Operand Descriptions
Usage Notes
COLLECT
Specifies that the trigger message received on the secondary or tertiary stream
is concatenated with the message being written to the output.
v DIVERT requires at least two input streams.
v When DIVERT has only two input streams, it acts as a gating function by
enabling the primary input to pass to the primary output as messages become
available on the secondary input. In this case, no message is passed to the
secondary output.
Examples
For example usage, see sample CNMSRPLY.
PIPE DIVERT
Chapter 2. Pipeline Stages and Syntax 71