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

Example: Understanding Error Messages
Assume that the preceding example is changed so that the variable X.3 used to
build the TAKE stage is misspelled as TAK. The following error messages are
displayed.
DWO364E PIPELINE TERMINATED. NO STAGE TAK EXISTS.
DWO362E PIPELINE TERMINATED. ERROR IN
STAGE 10003 IN PIPELINE "INNER"
The stage number is:
(3) + ((10000)(1)) = 10003
because TAKE is the third stage inserted by the INTERPRT stage in the pipeline
specification and INTERPRT is the first stage in its (inner) pipeline specification.
Example: Running a Large Pipeline
In this example, there is a large pipeline specification saved in member LGPIPE of
partitioned data set DSICLD. There must be one stage specification per record. To
run the pipeline, enter:
PIPE (NAME OUTPIPE) < DSICLD.LGPIPE
| COLLECT
| NETVIEW PIPE (NAME INPIPE) INTERPRT *
| LOGTO HCYLOG
The stages are read from the member and collected. The NETVIEW stage makes
this data the current message while running the command PIPE INTERPRT *. The
INTERPRT stage reads the records and inserts them into the inner pipeline
specification. The inner pipeline then runs. If there is any output from the inner
pipeline from a CONSOLE stage, that output is trapped by the outer pipeline and
passed to the next stage. In this case, the output is written to the hardcopy log.
You can add stages to the beginning or end of a pipeline specification that is to be
interpreted. In the preceding example, you can replace PIPE (NAME INPIPE)
INTERPRT * with this:
PIPE (STAGESEP % NAME INPIPE) LITERAL /SOME INPUT/
% INTERPRT *
% COLLECT
% CONSOLE
To the stages already defined in the member, you have added a first stage
(LITERAL) and two end stages (COLLECT and CONSOLE). The definition of a
new stage separator is necessary to avoid confusion with the stages of the outer
pipeline, but has no effect on the stage specifications read from the member.
The new pipeline is shown below.
PIPE (NAME OUTPIPE) < DSICLD.LGPIPE
| COLLECT
| NETVIEW PIPE (STAGESEP % NAME INPIPE) LITERAL /SOME INPUT/
% INTERPRT *
% COLLECT
% CONSOLE
| LOGTO HCYLOG
PIPE INTERPRT
Chapter 2. Pipeline Stages and Syntax 145