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

Examples
v When VAR is not the first stage of a pipeline specification, the following
conditions apply:
– The variable specified on the VAR stage is initially dropped. Under REXX,
this is equivalent to the REXX DROP function. Under REXX, the SYMBOL
function indicates that the variable is of type LIT. In the NetView command
list language and HLL, the variable is set to null and has a zero length.
Therefore, if VAR is not the first stage and is never called to process message
buffers for a given pipeline, the value is dropped when the pipeline
completes.
– If the first input buffer to the VAR stage is an MLWTO, only the first message
line of the MLWTO is saved to the named variable, and the entire MLWTO is
sent to the output stream.
Example: Writing to Named Variables
To select the first five data elements from the 'DATA.' stem and save them into
variables A, B, C, D, and E respectively, run the following REXX COMMAND LIST.
/* REXX COMMAND LIST */
’PIPE STEM DATA.’
’|VARABCDE’
Example: Using the STAGESEP Stage for DBCS Problems
You can use the following command for character problems encountered in DBCS:
DATA1 = sql statements including x’4Fxx’
’PIPE (END %) LITERAL /’ DATA1’/ | ------’ ===> results: BAD
’PIPE (END %) VAR DATA1 | EXCUTE ------ ’ ===> results: GOOD
PIPE VAR and PIPE $VAR
Chapter 2. Pipeline Stages and Syntax 253