28.11.2012 Views

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

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

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

SHOW MORE
SHOW LESS

You also want an ePaper? Increase the reach of your titles

YUMPU automatically turns print PDFs into web optimized ePapers that Google loves.

Pipeline Stages and Syntax<br />

22 <strong>Programming</strong>: <strong>Pipes</strong><br />

specification, then the % character is removed and the following | character is<br />

not treated as a stage separator. This leaves the string ABC|XYZ in your stage<br />

specification.<br />

The valid value of ESC is that of any character acceptable <strong>for</strong> STAGESEP, but it<br />

cannot be the same value as that used <strong>for</strong> STAGESEP or END in the same PIPE<br />

command.<br />

Alternatively, you can use the stage separator character to “self escape” itself.<br />

Two side-by-side separators resolve to one such character taken literally. For<br />

example:<br />

PIPE LITERAL 'MY CHAR IS ||' | CONSOLE<br />

Results in the display of the following text:<br />

MY CHAR IS |<br />

label<br />

The label must be 1-8alphanumeric characters followed by a colon. A label<br />

can be followed by blanks. Although you can assign a label to any stage, label<br />

is only useful when used with the end character and stages with multiple<br />

output streams to create complex pipelines. For in<strong>for</strong>mation on creating<br />

complex pipelines, see “Complex Pipelines” on page 7.<br />

LOWQENAB<br />

Commands that are queued at a low priority are not processed until pipeline<br />

processing is complete. Commands blocked include low-priority commands<br />

from the automation table. Blocking low-priority commands assures that the<br />

commands are processed first in-first out (FIFO).<br />

High-priority commands pre-empt pipeline processing.<br />

When LOWQENAB is specified, pipeline processing is temporarily suspended<br />

whenever any command is queued. Even low-priority commands pre-empt<br />

pipeline processing.<br />

LOWQENAB affects only the pipeline where it is specified. All other<br />

automation and low priority commands continue to run in FIFO order.<br />

NAME<br />

Indicates the name of this pipeline. The name given is used in various<br />

messages about the processing of the pipeline and can be an aid in debugging.<br />

pipename<br />

The value is 1-8alphanumeric characters. The default value is PIPE.<br />

stage_specification<br />

A <strong>NetView</strong> stage and its operands. This can be a label previously defined in<br />

the pipeline that is used as a connector in a complex pipeline. At least one<br />

stage or connector label must be specified.<br />

STAGESEP<br />

Specifies the character used to separate the stages in a PIPE command.<br />

The STAGESEP, END, and ESC characters must be different within a single<br />

pipe specification.<br />

value<br />

Is a single-byte, nonalphanumeric EBCDIC character except blank, null, ), (, @,<br />

#, and $.

Hooray! Your file is uploaded and ready to be published.

Saved successfully!

Ooh no, something went wrong!