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

NetView Pipeline Filters
310 Programming: Pipes
NCCF NETVIEW CNM01 OPER6 02/01/10 13:38:00
* CNM01 PIPE NETVIEW D NET,CDRMS | CORRWAIT 60 | TOSTRING LAST 1.7
/IST314I/| 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
Processing steps:
1. The NETVIEW stage executes the command to DISPLAY CDRMS and writes
the messages to the output stream.
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. Before 60 seconds expire, the message DISPLAY ACCEPTED is passed to
TOSTRING and the last (only) line is examined for the matching string. There
is no match, so the message is passed to the output stream.
4. Again, before 60 seconds expire, the MLWTO is passed to TOSTRING and
because the last line of the MLWTO matches the delimited text string, the entire
MLWTO is passed to the output stream. Because TOSTRING is satisfied, the
TOSTRING stage terminates, making CORRWAIT also terminate, and ending
the receipt of messages from the D NET,CDRMS command.
5. The CONSOLE stage reads the messages and displays them.
Example 2: Processing Single-Line Messages Using TOSTRING
This example shows how to use TOSTRING to search for a delimited string in a
particular column range, within single-line messages. This example is shown as a
REXX command list named DISP482I:
/* DISP482I REXX command list */
/* process PIPE command with TOSTRING stage
’PIPE NETVIEW D NET,CDRMS’,
*/
’| CORRWAIT 60’, /* wait 60 seconds */
’| SEPARATE’, /* split up MLWTO */
’| TOSTRING 1.7 /IST482I/’, /* search for match */
’| CONSOLE’
SAY ’RC IS ’ RC
EXIT
/* display on screen */
Output from DISP482I looks similar to:
NCCF NETVIEW CNM01 OPER6 03/26/10 16:50:00
* CNM01 DISP482I
CNM01 IST097I DISPLAY ACCEPTED
’ CNM01 IST350I DISPLAY TYPE = CDRMS
’ CNM01 IST089I A01CDRM TYPE = CDRM SEGMENT , ACTIV
’ CNM01 IST482I A01M ACTIV, SA 1, EL 1, NETID = NETA
C CNM01 RC IS 0
Processing steps:
1. The NETVIEW stage executes the DISPLAY command and writes messages,
which include an MLWTO to the output stream.