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

PIPE SEPARATE
Syntax
Synonyms
SEPARATE:
SEPARATE
SEQUENCE
DATA
Stage Name Synonym
SEPARATE SEP
Command Description
The SEPARATE stage transforms input multiline messages into multiple single-line
messages. Input single-line messages are passed without being changed. Output
single-line messages inherit all of the attributes of the input messages that created
them.
Streams
The output of SEPARATE consists of single-line messages. Generally, the number
of output messages is more than the number of input messages. When SEPARATE
generates many single-line messages from an input multiline message, all of the
output messages have the same message attributes as the message from which they
are derived. For example, a 10-line message received from JOB STC00040 exactly at
noon and passed through SEPARATE yields 10 distinct single-line messages, each
with JOBNAME STC00040 and all apparently received at the same microsecond. If
you later display these 10 messages with a CONSOLE stage and subsequently
receive a DOM that would have matched the original multiline message, then that
DOM matches all 10 of the separated messages.
Stream Type Number Supported
Input 1
Output 2 (DATA)
10 (SEQUENCE)
Termination Conditions
SEPARATE terminates when the input stream or all output streams disconnect.
Operand Descriptions
PIPE SEPARATE
DATA
Specifies that the lines labeled as data lines, or data-end lines, are passed to the
primary output stream. All other lines are passed to the secondary output
stream. If a secondary output stream is not defined, all lines which are neither
data nor data-end lines are discarded.
Chapter 2. Pipeline Stages and Syntax 211