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

Introduction and Concepts
14 Programming: Pipes
NCCF NETVIEW CNM19 PETE 03/26/10 13:10:00
* CNM19 PIPE < WISHLIST | CONSOLE
| CNM19 CAIRO, EGYPT AFRICA
| CNM19 CASABLANCA, MOROCCO AFRICA
| CNM19 KRUGER PARK AFRICA
| CNM19 NILE RIVER AFRICA
| CNM19 BANGKOK, THAILAND ASIA
| CNM19 GREAT WALL, CHINA ASIA
| CNM19 TOKYO, JAPAN ASIA
| CNM19 YANGTZE RIVER ASIA
| CNM19 ALICE SPRINGS AUSTRALIA
| CNM19 PARIS, FRANCE EUROPE
| CNM19 RHINE RIVER EUROPE
| CNM19 ROME, ITALY EUROPE
| CNM19 GRAND CANYON PARK, ARIZONA, USA N. AMERICA
| CNM19 MISSISSIPPI RIVER N. AMERICA
| CNM19 NEW YORK, NEW YORK, USA N. AMERICA
| CNM19 YOSEMITE PARK, CALIFORNIA, USA N. AMERICA
| CNM19 DANALI PARK, ALASKA, USA N. AMERICA
| CNM19 AMAZON RIVER S. AMERICA
| CNM19 ANDES MOUNTAINS S. AMERICA
| CNM19 RIO DE JANIERO, BRAZIL S. AMERICA
???
Pete is an avid canoeist, so he decides to change the pipeline specification to limit
his selection of vacation spots to those with rivers. He accesses the same disk file
shown in the previous example, but he now enters this PIPE command:
PIPE < WISHLIST
| LOCATE /RIVER/
| LITERAL /Pete’s canoeing adventures/
| CONSOLE
Actually, if Pete had entered that command on a command line, he would have
been limited to three lines and would have entered it in landscape form, but it is
shown here in portrait form for ease of reading.
Pete's command uses the LOCATE stage to select all messages that contain the
character string RIVER. Messages not selected are discarded from the pipeline and
are no longer available for subsequent processing by other stages. To indicate that
the choices are his, Pete uses the LITERAL stage to add a comment to the pipeline.
The LITERAL stage writes text to the pipeline ahead of messages already there. As
before, the results are displayed to the operator console, using the CONSOLE
stage.
The specification for the LOCATE stage is LOCATE /RIVER/. The operand RIVER is
supplied as a search argument for the stage to use when examining messages. The
slash (/) character is the string delimiter.
The specification for the LITERAL stage is:
LITERAL /Pete’s canoeing adventures/
The operand (Pete’s canoeing adventures) represents the text to be placed in the
pipeline.
In this example, the