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

NetView Pipeline Filters
306 Programming: Pipes
Keeping or Discarding Matching Messages: LOCATE,
NLOCATE
The LOCATE stage keeps messages that contain specified text strings and discards
messages that do not. Conversely, the NLOCATE stage discards messages that
contain specified text strings and keeps messages that do not. You can specify up
to 40 delimited strings, each with optional position and length to limit the column
range of the search.
Example 1: Keeping Messages that Contain a Specified Text String
This example shows how to use the LOCATE stage to select single-line messages
that contain a specified text string:
PIPE NETVIEW LIST STATUS=TASKS | LOCATE /OST/ | CONSOLE
Output from the pipeline looks like this:
NCCF NETVIEW CNM01 OPER6 05/17/10 13:38:00
* CNM01 PIPE NETVIEW LIST STATUS=TASKS | LOCATE /OST/ | CONSOLE
- CNM01 TYPE: OST TASKID: OPER6 RESOURCE: A01A701 STATUS: ACTIVE
- CNM01 TYPE: OST TASKID: RESOURCE: A01A702 STATUS: NOT ACTIVE
- CNM01 TYPE: OST TASKID: RESOURCE: A01A703 STATUS: NOT ACTIVE
- CNM01 TYPE: OST TASKID: RESOURCE: A01A704 STATUS: NOT ACTIVE
- CNM01 TYPE: OST TASKID: RESOURCE: A01A705 STATUS: NOT ACTIVE
- CNM01 TYPE: OST TASKID: RESOURCE: A01A706 STATUS: NOT ACTIVE
- CNM01 TYPE: OST TASKID: RESOURCE: STATUS: NOT ACTIVE
- CNM01 TYPE: OST TASKID: RESOURCE: STATUS: NOT ACTIVE
- CNM01 TYPE: OST TASKID: RESOURCE: STATUS: NOT ACTIVE
- CNM01 TYPE: OST TASKID: RESOURCE: STATUS: NOT ACTIVE
- CNM01 TYPE: OST TASKID: RESOURCE: STATUS: NOT 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
Processing steps:
1. The NETVIEW stage executes the LIST command and writes the results to the
output stream as single-line messages.
2. The LOCATE stage reads its input stream (output stream of the NETVIEW
stage), examines the messages for occurrences of the OST string, and writes all
matching messages to the output stream discarding unmatched messages.
3. The CONSOLE stage reads the messages and displays them.
Example 2: Keeping Messages that Contain Multiple Text Strings
This example shows how to use the LOCATE stage to select messages containing
any one of the multiple text strings specified:
PIPE NETVIEW LIST DEFAULTS | SEPARATE | LOCATE /LOG/ /DISP/| CONSOLE
Output from the pipeline looks similar to:
NCCF NETVIEW CNM01 OPER6 05/17/10 13:40:30
* CNM01 PIPE NETVIEW LIST DEFAULTS | SEPARATE | LOCATE /LOG/ /DISP/ |
CONSOLE
’ CNM01 DWO654I DISPLAY DEFAULTS
’ CNM01 SYSLOG: NO
’ CNM01 NETLOG: YES
’ CNM01 HCYLOG: YES
’ CNM01 DISPLAY: YES