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

NetView Pipeline Filters
308 Programming: Pipes
2. The NLOCATE stage reads the messages and examines them for the NOT ACTIVE
string in columns 55 - 64. If that string is found, the message is discarded. All
other messages are written to the output stream.
3. The CONSOLE stage reads the messages and displays them.
Note: If the example were changed to add an additional selection criteria to the
NLOCATE stage, searching for OPT in columns 7-9,theresults from the
pipeline are similar to.
NCCF NETVIEW CNM01 OPER6 05/17/10 13:38:43
* CNM01 PIPE NETVIEW LIST STATUS=TASKS | NLOCATE 55.10 /NOT ACTIVE/ 7.3
/OPT/ | CONSOLE
- CNM01 TYPE: MNT TASKID: MNT RESOURCE: CNM01 STATUS: ACTIVE
- CNM01 TYPE: PPT TASKID: CNM01PPT RESOURCE: CNM01PPT STATUS: ACTIVE
- CNM01 TYPE: OST TASKID: OPER6 RESOURCE: A01A702 STATUS: ACTIVE
- CNM01 TYPE: OST TASKID: AUTO1 RESOURCE: AUTO1 STATUS: ACTIVE
- CNM01 TYPE: OST TASKID: AUTO2 RESOURCE: AUTO2 STATUS: ACTIVE
- CNM01 TYPE: OST TASKID: DSILCOPR RESOURCE: DSILCOPR STATUS: ACTIVE
- CNM01 END OF STATUS DISPLAY
Example 4: Using NLOCATE to Process an MLWTO
This example shows how to use the NLOCATE stage to discard an MLWTO that
contains a specified text string:
PIPE NETVIEW LIST DEFAULTS | NLOCATE /LOG/ | CONSOLE
Output from the pipeline is similar to:
NCCF NETVIEW CNM01 OPER6 02/01/10 10:11:15
* CNM01 PIPE NETVIEW LIST DEFAULTS | NLOCATE /LOG/ | CONSOLE
Processing Steps:
1. The NETVIEW stage executes the LIST command and writes the results to the
output stream as an MLWTO.
2. The NLOCATE stage reads its input stream, examines the messages for the LOG
text string and because LOG occurs at least once in the MLWTO, the entire
MLWTO is discarded.
3. Because there are no messages in its input stream, the CONSOLE stage ends
without displaying anything. Only the command echo is seen.
Note: If the example is changed to insert the SEPARATE stage prior to the
NLOCATE stage, the pipeline results change. The SEPARATE stage breaks
the output of the LIST command, an MLWTO, into single-line messages.
NLOCATE reads its input stream, and examines each single-line message
(instead of the entire MLWTO) for the occurrence of LOG, discarding matches
as appropriate.
PIPE NETVIEW LIST DEFAULTS | SEPARATE | NLOCATE /LOG/ | CONSOLE
Output (first page) from the pipeline looks similar to: