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

Examples
v Line count attributes set by EACHLINE are preserved, when calling a command
with a message providing the target command, contains no processing that alters
the current message.
v Message count attributes set by EACHMSG are not preserved when calling a
command with the message.
Example: Counting Messages
The following example counts the number of messages copied by ASSIGN to the
operators listed in the OPS. stem. REXX resolves the value for total in the PIPE for
each iteration of the DO loop. The PIPE then adds the count of the next operator's
assigned messages to total. After the messages for all operators in OPS. stem are
counted, the total count for all operators is returned in the SAY statement.
/* REXX Fragment */
...
total = 0;
DOdex=1TOOPS.0
’PIPE NETV LIST ASSIGN=COPY OP=’||OPS.dex,
’| LOCATE 1.7 /DSI637I/’,
’| COUNT LINES FROM’ total,
’| VAR total’
END
SAY ’There are’ total ’messages copied to the operators.’
...
Example: Line Counts Reset by Command
The line count values set by COUNT EACHLINE can be reset by a command.
Consider the following REXX CLIST:
/* REXX Example - Echo safe to console */
’PIPE SAFE *’,
’ | CONSOLE’
EXIT
Now, if we name this CLIST ECHO and we call ECHO from the following
pipeline, the line count attributes are preserved.
PIPE < INFILE
|COUNT EACHLINE
|NETVIEW /AUTO1: ECHO
|WAIT 10
|SAFE KEEPER
In this example a series of lines are read from INFILE. Each line is counted and the
line attributes added to the lines before they are passed to ECHO. ECHO reads the
current line passed from the PIPE through the SAFE stage and writes it as output
in this correlated environment. The line returns from ECHO to the above pipe
which is waiting for 10 seconds for the return from ECHO. The unchanged line is
stored in the SAFE named KEEPER.
Now, if ECHO was changed as follows:
/* REXX Example - Echo safe to console */
’PIPE SAFE *’,
’ | COUNT EACHLINE’,
’ | CONSOLE’
EXIT
PIPE COUNT
Chapter 2. Pipeline Stages and Syntax 61