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

Where:
stage_name
Is any NetView PIPE stage.
See “PIPE Stages” on page 24 for an alphabetic listing and brief summary of each
PIPE stage.
Operand Descriptions
DEBUG
Generates connection and data stream trace information that can be used to
debug pipelines. DEBUG, when used as a PipeOption, must have one of the
following items specified:
1 Produce debug output for all pipeline stages. This is the same as coding
(DEBUG) on each stage.
2 Produce additional debug information whenever a BNH155E message is
generated. BNH155E indicates that the pipeline is clogged. The additional
information produced by DEBUG 2 can help you diagnose the clog.
END
ESC
Both DEBUG 1 and DEBUG 2 can be specified in the same pipeline
specification.
For more information on the DEBUG option see Chapter 8, “Debugging
NetView Pipelines,” on page 345.
The end character allows multiple, simple pipelines to operate within a
complex pipeline. The pipeline specification, included after the end character,
operates independently of the pipeline specified before the end character. The
end character, with stage labels, and stages with multiple input or output
streams is used to create complex pipelines. For information on creating
complex pipelines, see “Complex Pipelines” on page 7.
The valid value of END can be a character acceptable for STAGESEP, but the
value cannot be the same value as STAGESEP or ESC in the same PIPE
command.
If you want to include the end character within your pipe where it must not be
interpreted as an end character, you can either include the ESC character
immediately before it or use the “self escape” technique. Two side-by-side
END characters resolve to one character taken literally. For example, if your
ESC character is defined as % and your END character is defined as ?, use
either of the following examples:
PIPE (END ?) LITERAL ’MY END CHARACTER IS ??’
| CONSOLE
PIPE (ESC % END ?) LITERAL ’MY END CHARACTER IS %?’
| CONSOLE
The following text is displayed on the console:
MY END CHARACTER IS ?
Pipeline Stages and Syntax
Indicates that the character following the specified character is treated literally
when the pipeline specification is parsed. For example, if you specify STAGESEP
| ESC % as options and the string ABC%|XYZ is encountered in the pipeline
Chapter 2. Pipeline Stages and Syntax 21