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

NetView Pipelines Device Drivers
This example shows how to use the < stage to read records from the CNME1035
member associated with ddname DSICLD.
PIPE < DSICLD.CNME1035 | LOCATE /STARTCNM/ | CONSOLE
Output from the pipeline looks like this:
NCCF NETVIEW CNM01 OPER6 04/14/10 15:26:40
* CNM01 PIPE < DSICLD.CNME1035 | LOCATE /STARTCNM/ | CONSOLE
| CNM01 STARTCNM ALL
Processing steps:
1. The < stage, reads the records from the member named CNME1035 associated
with the DSICLD ddname. The records are converted to single-line messages
and placed in the pipe.
2. The LOCATE stage selects all messages that have the text string STARTCNM and
places them in the pipe.
3. The CONSOLE stage reads the messages and displays them on the screen.
Accessing Variables within Command Procedures: VAR, STEM, SAFE
296 Programming: Pipes
Several device drivers read and write variables in a command procedure
environment.
You can:
v Read from or write uniquely named variables (VAR)
v Read from or write to stem variables (STEM)
v Read from or write to the command procedure message queue (SAFE).
Reading from or Writing to Named Variables: VAR
The VAR stage enables the user to read records from, or write records to, variables
in a command procedure variable pool.
When used as a first stage, VAR reads variables from a command procedure
variable pool into the pipeline. As anything other than the first stage, VAR writes
single-line messages or lines of a MLWTO to uniquely named variables.
Example: Working with a Variable
In this example, command list PIPEVAR illustrates how to use the VAR stage in a
pipeline to write a message to a variable. Another pipeline is then used to read the
variable and display it.
********************************************************************
PIPEVAR CLIST
&CONTROL ERR
********************************************************************
* NETVIEW command list language **
********************************************************************
PIPE NETVIEW DISPFK +
| SEPARATE +
| LOCATE /PA3/ +
| VAR CLVAR1
*
*
PIPE VAR CLVAR1 +
| LITERAL /PA3 IS:/ +
| CONSOLE
*