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

NCCF NETVIEW CNM01 OPER6 03/20/10 13:40:00
* CNM01 PIPE NETVIEW LIST ’’ | COLLECT | CONSOLE
- CNM01
STATION: OPER6 TERM: A01A701
HCOPY: NOT ACTIVE PROFILE: DSIPROFA
STATUS: ACTIVE
DOMAIN LIST: CNM01 (I) CNM02 (I) CNM20 (I) CNM99 (I)
ACTIVE SPAN LIST: NONE
END OF STATUS DISPLAY
NetView Pipeline Filters
Processing steps:
1. The NETVIEW stage executes a LIST command and writes the results to the
output stream as single-line messages.
2. The COLLECT stage reads its input stream and collects the single-line messages
into one MLWTO, before writing the MLWTO to the output stream. Notice that
there is only one message prefix for an MLWTO.
3. The CONSOLE stage reads its input and displays the MLWTO.
Note: If the COLLECT stage is not used, the pipeline output looks similar to the
following example:
NCCF NETVIEW CNM01 OPER6 04/14/10 13:45:00
* CNM01 PIPE NETVIEW LIST ’’ | CONSOLE
- CNM01 STATION: OPER6 TERM: A01A701
- CNM01 HCOPY: NOT ACTIVE PROFILE: DSIPROFA
- CNM01 STATUS: ACTIVE
- CNM01 DOMAIN LIST: CNM01 (I) CNM02 (I) CNM20 (I) CNM99 (I)
- CNM01 ACTIVE SPAN LIST: NONE
- CNM01 END OF STATUS DISPLAY
Selecting Messages by Content: LOCATE, NLOCATE, TOSTRING
Several stages select pipeline messages. That is, they read all messages in the
pipeline, but write only those that meet some selection criteria to the stage's output
stream. This section describes filters that select messages based on the content of
the message itself. You can:
v Keep all messages that contain a match for a specified text string (LOCATE)
v Discard all messages that contain a match for a specified text string (NLOCATE)
v Keep messages up to and including the message that contains a match for a
specified text string (TOSTRING)
All of these filters are case-sensitive: they pay attention to uppercase and
lowercase. To a filter, the words Apple and apple are not equal.
Sometimes the NetView program automatically translates input to uppercase. An
easy way to determine whether this is happening is to insert a CONSOLE stage
and notice whether the output to the screen is in uppercase. If case sensitivity is
required, code the PIPE command in a REXX command list using the ADDRESS
NETVASIS instruction to establish an environment sensitive to case. For additional
information about REXX command lists, see IBM Tivoli NetView for
z/OS Programming: REXX and the NetView Command List Language.
Chapter 4. NetView Pipeline Filters 305