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

PIPE VARLOAD
PIPE VARLOAD
Syntax
254 Programming: Pipes
VARLOAD:
VARLOAD
(0)
(COMMON)
(TASK)
(number)
Command Description
The VARLOAD stage is used to set values for variables that are passed in the
input stream. The names and values of the variables set by VARLOAD are
specified by the records passed on the primary input stream. VARLOAD sets one
variable for each input message containing a character other than a blank or
asterisk in the first position of the record. Messages beginning with a blank or
asterisk are ignored. All other messages are treated as delimited strings.
The use of the VARLOAD stage is limited to the command procedure
environments (REXX, NetView command list language, and HLL). However, if the
(COMMON) or (TASK) option is used, VARLOAD 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
VARLOAD stage outside of these environments results in message DSI290I and
termination of the pipeline.
Data passed to VARLOAD on the input stream can be in one of two formats:
v /variable1/value
v /variable1=variable2/value
If /variable1/value is specified, the variable name following the delimiter is set to the
value after the second delimiter. In the /variable1=variable2/value case, the current
value of variable1 is compared to the value of variable2. If they are equal, variable1 is
set to the value following the second delimiter. This is equivalent to the compare
and swap OS/390 function.
Notes:
1. Variable1 is read from the dictionary specified by (COMMON), (TASK), or
(number).
2. Variable2 is read from the local dictionary.
3. If variable1=variable2 is specified and is contained in a multiline message, all
multiline message comparisons are done first. If any comparison fails, no
variables are updated from the message data.
You can control which comparisons are grouped together using COLLECT and
SEPARATE.
All messages from the input stream are also written to an output stream. If a
secondary output stream is defined, the following items are written to the
secondary output stream:
v All input messages with errors in the variable name