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

PIPE TAKE
PIPE TAKE
Syntax
TAKE:
TAKE
FIRST
LAST
1
count
MSGS
LINES
Command Description
Use the TAKE stage to specify the number of messages or lines that are passed to
the primary output stream (if any). All messages or lines in excess of this number
are passed to the secondary output stream. If either primary or secondary stream is
disconnected, messages that would have been passed to the particular stream are
discarded.
Streams
Stream Type Number Supported
Input 1
Output 2
Termination Conditions
TAKE terminates when the input stream or both output streams are disconnected.
Operand Descriptions
Usage Notes
234 Programming: Pipes
count
Specifies the maximum number of messages or lines to be passed to the
primary output stream. Valid values are in the range of 0 - 10,000,000. The
default is 1.
FIRST|LAST
Specifies whether the messages or lines to be passed to the next stage are the
first count messages or the last count messages. The default is FIRST.
LINES
Specifies that the count is made of individual lines without regard to their
grouping as multiline messages. If the indicated count is satisfied during
processing of a multiline message and a secondary output is connected, then
the AIFR data for the multiline message is replicated and passed to the
secondary output, along with the remaining lines for that message.
MSGS
Specifies that the count indicated applies to whole messages, which can consist
of zero or more lines. This is the default.
v TAKE cannot be the first stage.
v TAKE LAST delays the stream. This means that TAKE LAST produces no output
until the previous stage disconnects its output stream. This causes delayed
processing by stages following TAKE LAST.