PIPE command

The PIPE command is a powerful and flexible command that lets you issue commands and manipulate messages in a pipeline. Many of the functions available in the HLL environment as commands and service routines are also available through the PIPE stage commands.

The PIPE command creates a message processing environment that lets you issue a command and wait for that command's response messages (either synchronous or asynchronous). PIPE ensures that only messages correlated to the command are received and processed in the pipeline. You can use the PIPE command to process commands that generate correlated responses instead of using the WAIT and TRAP commands. The command and message correlation provided through the PIPE command is a major advantage over the WAIT command. See Waiting and trapping using the PIPE command (PL/I) and Waiting and trapping Using the PIPE command (C) for examples of using PIPE in an HLL program.

For a description of the advantages of using the PIPE command instead of the WAIT command, refer to IBM® Tivoli® NetView for z/OS® Programming: Pipes.

The PIPE command also provides support for stem variables in the NetView® HLL environment. See Accessing stem variables using the PIPE command (PL/I) and Command list variable access (C) for an example of how to access local variables that have been stored in stem variables by the PIPE command.

The PIPE stage command, < (From Disk), provides similar function to the HLL service routines CNMMEMO, CNMMEMR and CNMMEMC. The PIPE stage commands, CONSOLE and LOGTO, provide function that is available through the CNMSMSG service routine. The PIPE command with these stages can be used in place of the associated HLL service routine in these cases. However, RID support is available only when the HLL service routine is used.

Note:
  1. The PIPE command cannot be issued from an HLL installation exit routine or from an HLL command procedure running under a DST. Refer to IBM Tivoli NetView for z/OS Programming: Pipes for a complete description of the PIPE command.
  2. To obtain information about the PIPE command and stage commands, use the online HELP facility:
    • To display information about the PIPE command, enter:
      HELP PIPE
    • To display information about a specific stage command, enter:
      HELP PIPE stage_command