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

3. The LOCATE stage selects inactive tasks and writes that information to the
pipeline.
4. The CONSOLE stage reads the messages and displays them.
Running a VTAM Command: VTAM
The VTAM stage enables the user to run a DISPLAY, VARY, or MODIFY VTAM
command in a local or remote domain.
Example 1: Issuing a VTAM Command
This example shows how to use the VTAM stage to issue a command:
PIPE VTAM D NET,STATIONS,SCOPE=ALL
| CORRWAIT 5
| NLOCATE /IST097I/
| TAKE 1
| CONSOLE
Output from the pipeline follows:
NCCF NETVIEW CNM01 OPER6 05/02/10 11:09:23
* CNM01 PIPE VTAM D NET,STATIONS,SCOPE=ALL | CORRWAIT 5 | NLOCATE /IST097I/
| TAKE 1 | CONSOLE
’ CNM01
IST350I DISPLAY TYPE = STATIONS
IST393I PU T4/5 MAJOR NODE A01MPU , SUBAREA = 1
IST172I NO LINK STATIONS EXIST
IST314I END
Processing steps:
1. The VTAM stage invokes the DISPLAY command and places the corresponding
response messages in the pipeline.
2. The CORRWAIT stage allows 5 seconds for each message to return from
VTAM. CORRWAIT must be used when sending commands to other
applications, such as VTAM or MVS, or to another NetView system to allow
enough time for a response to return.
3. The NLOCATE stage discards the IST097I message and passes the next
message, an MLWTO, to its output stream.
4. The TAKE 1 stage selects the first message in its input stream and also imposes
an early termination to the timer on the CORRWAIT stage.
5. The CONSOLE stage reads the message and displays it.
Example 2: Generating a Return Code from the VTAM Stage
This example shows how to use the VTAM stage with the MOE option to generate
a message containing a return code to the pipeline. The D NETT, TERMS
command is purposely incorrect.
PIPE VTAM MOE D NETT,TERMS | CORRWAIT 5 | CONSOLE
Output from the pipeline follows:
NetView Pipelines Device Drivers
NCCF NETVIEW CNM01 OPER6 04/29/10 11:01:20
* CNM01 PIPE VTAM MOE D NETT,TERMS | CORRWAIT 5 | CONSOLE
- CNM01 DSI071I INVALID VTAM COMMAND
- CNM01 DWO369I VTAM STAGE (1) HAD RETURN CODE 8.
CNM01 IST191I DISPLAY SYNTAX ERROR
Chapter 3. NetView Pipelines Device Drivers 293