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

Appendix. Additional NetView Pipeline Examples
This appendix documents general-use programming interface, associated guidance
information, and contains examples that show how stages can be combined
effectively.
Displaying Part of a Lengthy Automated Message
Displaying a small part of a long automated message, while continuing to preserve
the DOM criteria, can be done using a PIPE command.
An example might be a tape mount request message, IEF290E, which can be
automated to display at the NetView operator's terminal. Only the first few lines
might be of interest.
In this example, a job called BLDTAPE that requested a tape mount was submitted.
The panel below shows the message as it is displayed before any manipulation is
performed to decrease its length and content. Note the long list of available
devices in the message.
NCCF NETVIEW CNM19 OPER6 03/20/10 14:00:00
13:20 17:10 * CNM19 MVS S BLDTAPE " CNM19 IEF290E BLDTAPE BLDTAPE
SYSUT2 NEEDS 1 UNIT(S) FOR
VOLUME VSAM01
OFFLINE NOT ACCESSIBLE
D= D= 505, 506, 507, 508, 509
D= D= 50A, 50B, 50C, 50D, 50E
D= D= 50F, 516, 517, 518, 519
D= D= 51A, 51B, 51C, 51D, 51E
D= D= 51F, 520, 521, 522, 523
D= D= 524, 525, 526, 527, 528
D= D= 529, 52A, 52B, 52C, 52D
D= D= 52E, 52F, 530, 531, 532
D= D= 533, 534, 535, 536, 537
D= D= 538, 539, 53A, 53B, 53C
D= D= 53D, 53E, 53F, 540, 541
D= D= 542, 543, 544, 545, 546
D= D= 547, 548, 549, 54A, 54B
D= D= 551, 552, 553, 554, 555
D= D= 556, 557, 558, 559, 55A
D= D= 55B, 55C, 55D, 55E, 55F
D= D= 560, 561, 562, 563, 564
??? ***
Figure 25. Job BLDTAPE Example
The message is automated through the following automation table entry, which
routes a command list named PIPEMSG to OPER6.
IF MSGID = ’IEF290E’ .
THEN EXEC(ROUTE(ONE OPER6) CMD(’PIPEMSG’));
The PIPEMSG command list shown here uses the PIPE command to reduce the
message to two lines before displaying. The stage named SAFE reads the message
buffers which were automated. The message read is an MLWTO. The second stage,
SEPARATE, breaks the MLWTO into individual lines. The TAKE stage selects the
first 2 lines, while discarding other messages from the pipeline. The last stage,
CONSOLE, displays the pipeline contents to the operator's console.
© Copyright IBM Corp. 1997, 2011 353