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

PIPE INTERPRT
Usage Notes
Examples
144 Programming: Pipes
v INTERPRT can be used anywhere in the pipeline specification.
v Do not include an INTERPRT stage among the stages being inserted by the
INTERPRT stage.
v All stages are assigned numbers based on their position in the pipeline
specification. These numbers are shown in some error messages. Stage names
inserted by the INTERPRT stage are assigned numbers according to the
following formula:
(pn) + ((10000)(sn))
Where:
pn Specifies the positions of the stages in the pipeline specification.
sn Specifies the stage number of the INTERPRT stage in the pipeline
specification.
Example: Building Large Pipeline Specifications
Assume that the following variables are defined as input to the STEM stage of the
pipeline specification below. OPER_CMD is a command of unknown size. Using
the INTERPRT stage provides for the possibility that OPER_CMD can cause the
pipeline specification to exceed the 240-character limit.
/* SAMPLE REXX COMMAND LIST */
X.0=5
X.1 = ’NETVIEW’ OPER_CMD
X.2 = ’SEPARATE’
X.3 = ’TAKE 10’
X.4 = ’COLLECT’
X.5 = ’CONSOLE’
/* */
/* Collect the data records from the STEM X stage */
/* (X is the name of the variables), and drive */
/* the INTERPRT stage. */
/* */
’PIPE (NAME OUTER) STEM X.’,
’| COLLECT’,
’| NETVIEW PIPE (NAME INNER) INTERPRT *’,
’| CONSOLE’
EXIT
During processing of the preceding command, the data records from the STEM
stage are formed into a multiline message. The NETVIEW stage uses the pipeline
message it receives to drive the INTERPRT stage. The INTERPRT stage interprets
each of the data records in the message as a complete stage specification, then
builds stages from the input data for the command. All such stages are substituted
into the pipeline specification in place of the INTERPRT stage.
An equivalent pipeline created without using the INTERPRT stage is shown below.
This pipeline is simpler but fails if the size of OPER_CMD forces the entire
specification to become too large.
/* SAMPLE REXX COMMAND LIST */
’PIPE NETVIEW’ OPER_CMD,
’| SEPARATE’,
’| TAKE 10’,
’| COLLECT’,
’| CONSOLE’
EXIT