PIPE Command

You can issue the NetView® PIPE command anywhere you use a NetView regular (Type=R) command:
  • The NetView command line
  • A NetView command list
  • A REXX command list
  • A high-level-language command procedure such as PL/I or C
  • An environment that allows timer commands.
In a PIPE command, stages are separated by a character called a stage separator.
PIPE STAGE1 | STAGE2 | ... | STAGEn

A stage separator placed before the first stage or after the last stage is optional.

The default stage separator is the character X'4F'. Depending on your workstation, this stage separator is either a solid vertical bar (|) or a split vertical bar (¦).

PIPE commands can be shown in two ways: the portrait format or the landscape format. In portrait format, parameters are stacked vertically in the manner shown in Figure 1. In landscape format, parameters are strung horizontally as shown in Figure 2. When entering a PIPE command from the command line, you might prefer landscape form. When issuing a PIPE command from a command procedure, you might prefer the portrait form. Either form, or any combination of the two, is valid.

Note: In portrait form you must include the appropriate continuation character for the programming language after each line except the last.

For readability, most examples in this book are shown in portrait form.

Figure 1. A PIPE Command Coded in Portrait Format
     PIPE STAGE1
        | STAGE2
        | STAGE3
        | STAGE4
        | STAGE5
        | STAGE6
Figure 2. A PIPE Command Coded in Landscape Format
     PIPE STAGE1 | STAGE2 | STAGE3 | STAGE4 | STAGE5 | STAGE6

For more information, see Pipeline Stages and Syntax.