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

MAX
Specifies setting a limit for the maximum number of messages (not lines). This
option is used with the number variable.
number
Specifies the maximum number of input messages that are to be collected.
pos.len
Specifies where, within each line of input, COLLECT attempts to find the
specified delimited string. You can specify the letter S for the length if the
specification is followed by a delimited string. The COLLECT stage replaces
the letter with the length of that delimited string.
Usage Notes
PIPE COLLECT
NOT
When specified on the first string, indicates that the selection begins if the
string is not found. When specified on the second string, indicates that the
selection ends if the string is not found.
ONCHANGE
Specifies that when the message being examined is different from the previous
message in the range indicated by pos.len, then any previously accumulated
lines are output and a new multiline message is begun with the message being
examined. Only the first line of a multiline input message is examined.
/string/
Specifies the character string for which to search. If BREAK is specified, the
delimited string is required; otherwise, it is not allowed. You can specify
/string/ up to 40 times.
The first nonblank character encountered after BREAK AT, BREAK BEFORE, or
BREAK AFTER is the delimiter which establishes the boundary of the text
string used by the stage. The delimited string ends when the same character is
encountered a second time.
BLANK
Specifies that the character string for which to search contains only blanks. The
search occurs in the range specified by the pos.len parameter, but if the data
contains only blanks, a match is recognized regardless of the length specified.
NULL
Specifies that the stage is to search for no data whatsoever, that is, null data
(not even blanks). This means that a match is recognized only when the data is
shorter than the number specified for position in the pos.len parameter.
v COLLECT cannot be a first stage.
v Each of the COLLECT parameters (except for FREEFORM) specifies a condition
to stop collecting. With the addition of the MAX parameter, a single COLLECT
stage can have two such conditions. When either condition is met, a multiline
message is produced and COLLECT starts again.
v If you use the COLLECT stage following a STEM stage, see the description of
the COLLECT operand of the STEM stage for a more efficient alternative.
v The COLLECT stage directly affects the way that messages in the pipeline are
displayed, logged, and searched by other stages. It can be used to improve the
readability of messages when displayed to the operator console.
v The COLLECT stage delays the stream. This means that subsequent stages
cannot process data until COLLECT completes its collection of a multiline
Chapter 2. Pipeline Stages and Syntax 41