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

PIPE COLLECT
Streams
40 Programming: Pipes
If a secondary input stream is not defined for the COLLECT stage and FREEFORM
is not specified:
v If the first line of a multiline message is a data line, it is handled as a control
line.
v For each multiline message produced, COLLECT l accepts up to six label lines
from the primary input stream. These lines must have previously been
designated as label lines.
v All lines after the sixth, or after the first data line, are handled as data lines
regardless of how they were previously designated.
v The last line received on the primary input stream is used as an end line.
Stream Type Number Supported
Input 2
Output 1
Termination Conditions
COLLECT terminates when the primary input stream or the output stream is
disconnected.
Operand Descriptions
If no operands are given, COLLECT creates one multiline message containing all
input lines, and must delay its output until the previous stage disconnects.
AFTER
Specifies that the message containing the matching string is appended to
whatever is collected at that point.
ASBEFORE
Specifies that the output is collected as it was previously. This usually applies
to messages obtained using the SEPARATE stage, but can also apply to
messages replicated exactly using other techniques.
AT Discard the entire message containing the matching string. This is the default
value.
BEFORE
Specifies that when the message containing the matching string is detected, it
is kept to begin a new multiline message and is not part of the output
produced.
BREAK
Causes collected lines to be issued when a string match is detected. A
delimited string is required if BREAK is used. See the AT, AFTER, and
BEFORE keywords for disposition of the message containing the matching
string.
FREEFORM
No validation of the existing line types of input message is performed. As a
result, the line types are not modified by the COLLECT stage. For example, if a
message with a line type of Control follows a message with a line type of
Data, and a message with a line type of Data follows a message with a line
type of End, the collected multiline message is built with this erroneous
sequence.