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

2. The CORRWAIT stage allows a 60 second wait for messages to be returned
from VTAM, resetting the timer as each message is received. When the
CORRWAIT timer expires, further messages generated by the NETVIEW stage
are not accepted into the pipeline.
3. The SEPARATE stage reads its input stream and splits the MLWTO into
single-line messages, each message preserving the characteristics of the
MLWTO.
4. The TOSTRING stage examines each message for an occurrence of IST482I,
which begins in column 1. Each message is read and passed to the output
stream until a match is found.
5. The CONSOLE stage reads its input and displays the messages.
Selecting Messages by Position: TAKE, DROP
Pipeline messages are processed by a stage respective to the order of their position
in the pipeline. Several stages enable the user to either keep or discard records
based on their position.
You can specify the first or last n messages to be:
v Kept in the pipeline
v Discarded from the pipeline
Keeping the First or Last n Messages: TAKE
Example 1: Keeping the First two Messages in the Pipeline
This example shows how to use the TAKE stage to select the first two messages to
remain in the pipeline:
PIPE NETVIEW D NET,CDRMS | CORRWAIT 60 | TAKE 2 | CONSOLE
Output from the pipeline looks similar to:
NCCF NETVIEW CNM01 OPER5 03/01/10 11:00:00
* CNM01 PIPE NETVIEW D NET,CDRMS | CORRWAIT 60 | TAKE 2 | CONSOLE
CNM01 IST097I DISPLAY ACCEPTED
’ CNM01
IST350I DISPLAY TYPE = CDRMS
IST089I A01CDRM TYPE = CDRM SEGMENT , ACTIV
IST482I A01M ACTIV, SA 1, EL 1, NETID = NETA
IST482I A02M NEVAC, SA 2, EL 1, NETID = NETA
IST482I A99M NEVAC, SA 99, EL 1, NETID = NETA
IST482I B20M NEVAC, SA N/A, EL N/A, NETID = NETB
IST314I END
NetView Pipeline Filters
Processing steps:
1. The NETVIEW stage executes the DISPLAY command and writes messages to
the output stream.
2. The CORRWAIT stage allows a 60 second wait for a message to be returned
from VTAM, then resets the timer to wait for the next message. When the
CORRWAIT timer expires, messages generated by the NETVIEW stage are not
accepted into the pipeline.
3. Before the 60 seconds expire, the first message DISPLAY ACCEPTED is passed to
TAKE and is passed on to the output stream. The CORRWAIT timer is reset.
4. Again, before the 60 seconds expire, the second message, an MLWTO, is passed
to TAKE and is passed to the output stream. TAKE has now selected 2
messages; therefore, it terminates.
Chapter 4. NetView Pipeline Filters 311