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

PIPE COLLECT
Syntax
COLLECT:
►
Synonyms
COLLECT
MAX
number FREEFORM
ASBEFORE
BREAK ONCHANGE pos.len
AT
BREAK /string/
AFTER pos.len NOT BLANK
BEFORE NULL
Stage Name Synonym
COLLECT COL
Stage Operands Synonym
ASBEFORE ASB4
FREEFORM FF
PIPE COLLECT
Command Description
The COLLECT stage creates a multiline message, or messages, from the input
messages. The attributes of the output are inherited from the first line collected for
that message.
If a secondary input stream is defined for the COLLECT stage:
v COLLECT reads input from the secondary input stream until it becomes
disconnected. After the disconnect, it reads from the primary input stream.
v COLLECT uses all lines read from the secondary input stream as label lines for
the produced multiline messages.
Note: COLLECT accepts any number of lines on the secondary input stream to
be used as label lines. However, NetView presentation services recognizes
only the first six lines as label lines. The remainder are treated as data
lines.
v Unless FREEFORM is specified, all lines, except the last, read from the primary
input stream os used by COLLECT as data lines, regardless of their current
state, in the produced multiline message. The last line received on the primary
input stream is used as an end line.
If a secondary input stream is not defined for the COLLECT state and FREEFORM
is specified:
v The line type is not validated or modified for any line.
Chapter 2. Pipeline Stages and Syntax 39
►