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

PIPE VAR and PIPE $VAR
Syntax
VAR and $VAR:
VAR
$VAR
(0)
(COMMON)
(TASK)
(number)
▼ name
Command Description
The VAR stage can be used anywhere in the pipeline specification.
Streams
When VAR is the first stage, records are read from the variable specified. Each
record is passed as a single-line message to the pipeline output stream.
When VAR is specified as a subsequent stage, lines are read from its input stream
and are written to both the specified variables and to its output stream. The VAR
stage ignores the multiline nature of the input. VAR stores data from the first line
input into the first variable named, the second line into the second variable, and so
on. All messages are passed unaltered to the secondary output, if connected.
When all specified variables have been assigned, VAR writes subsequent messages
directly to its output stream.
The use of the VAR stage is limited to the command procedure environments
(REXX, NetView command list language, and HLL). However, if the (COMMON)
or (TASK) option is used, VAR can be invoked from message automation, by
command originating at the PPT task or an optional task, or by using a labeled
command originating in a command procedure. Use of the VAR stage outside of
these environments results in message DSI290I and termination of the pipeline.
By contrast, the STEM stage reads and writes to variables within a stemmed array.
The $VAR stage is the same as VAR, except that it also reads or writes the VIEW
attribute variables (which start with $) that are associated with the specified data
variables. When $VAR is the first stage, the color and highlighting specified in the
attribute variables are translated to the output messages. When $VAR is not the
first stage, the color and highlighting attributes specified in the input messages are
translated to the attribute variables.
Stream Type Number Supported
Input 1
Output 1
PIPE VAR and PIPE $VAR
Chapter 2. Pipeline Stages and Syntax 251