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

Termination Conditions
If specified as a first stage, STEM and $STEM terminate when the output stream
disconnects or when the end of the data stored is reached. If specified as a
subsequent stage, STEM and $STEM terminate when the input stream disconnects.
Operand Descriptions
PIPE STEM and PIPE $STEM
(COMMON)
Specifies that the common global variable dictionary is accessed instead of
your personal variable dictionary.
(TASK)
Specifies that the task global variable dictionary is accessed instead of your
personal variable dictionary.
APPEND
Specifies that new data is appended as additional STEM variables following
STEM data that already exists as determined by the count in element zero.
APPEND can be used only on a stage that is not first.
The APPEND option is not enabled if STEM is the first stage. For processing of
the APPEND option, the record count of the STEM variable must be zero or
positive.
COLLECT
Causes STEM to build one multiline message instead of many single-line
messages. COLLECT is allowed only when STEM is the first stage in a
pipeline. Using the COLLECT operand on the STEM stage is the functional
equivalent of using the STEM stage followed by the COLLECT stage, but it is
faster and uses less storage. Collect can only be used on a first stage.
stemroot
Specifies the name of the STEM variable to read from or write to. End it with a
period (.) if you are using a REXX command procedure. Do not include an
ampersand (&) in the name (an ampersand is implied in the NetView
command list language). The name length (name plus appended STEM count)
can be up to 11 characters in the NetView command list language and up to 31
characters in REXX and HLL except when $STEM is used, in which case, the
limits are 10 and 30, respectively. Lowercase characters in the name are
changed to uppercase before being processed. The &1 - &31 variables as used
in the NetView command list language are not supported for use in the STEM
stage. However, you can assign these values to or from other named variables,
which you can use in the STEM stage.
The record count for the STEM variable is name with a zero appended to it.
The count indicates how many records the STEM variable contains. The STEM
records are composed of name with a numeric value appended.
(number)
Specifies the number invocations (generations) to refer when setting the
variables. The number of generations refers to the current nesting level within
the REXX, PL/I, or C calling sequence.
(Number) must be zero (0) or greater, and less-than or equal-to the existing
number of generations. If (number) is greater than (0), the variables are in a
generation preceding the current generation. The specified generation can
precede the generation from which the PIPE command is issued if such a
generation exists.
Chapter 2. Pipeline Stages and Syntax 227