28.11.2012 Views

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

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

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

SHOW MORE
SHOW LESS

You also want an ePaper? Increase the reach of your titles

YUMPU automatically turns print PDFs into web optimized ePapers that Google loves.

Pipeline Stages and Syntax<br />

Examples<br />

Example: Changing the Separation Character with STAGESEP<br />

To change the stage separation character from the default value of a vertical bar (|)<br />

to a period (.), run a <strong>NetView</strong> LIST command, and display the resulting messages,<br />

enter:<br />

PIPE (STAGESEP .) NETVIEW LIST STATUS=TASKS<br />

. CONSOLE<br />

Example: Changing the Separation Character and Setting an<br />

Escape Character<br />

To change the stage separation character from the default value of a vertical bar (|)<br />

to a period (.), use double quotation marks (") as an escape character, run a<br />

<strong>NetView</strong> LIST command, discard messages containing the phrase NOT ACTIVE in<br />

positions 55 through 64, and display the resulting messages, enter:<br />

PIPE (STAGESEP . ESC ") NETVIEW LIST STATUS=TASKS<br />

. NLOCATE 55".10 /NOT ACTIVE/<br />

. CONSOLE<br />

In this example, the escape character is used, so that the period separating the<br />

NLOCATE search parameters is not read as a stage separator.<br />

PIPE Stages: Table 2 contains an alphabetic summary of the stages in the PIPE<br />

command and shows the minimum synonym allowed <strong>for</strong> each stage in a pipeline<br />

specification.<br />

The <strong>NetView</strong> sample CNMS1101 contains many of the examples shown in the<br />

stage descriptions.<br />

Table 2. Stages of the PIPE Command<br />

Stage Name Task Per<strong>for</strong>med Synonym Page<br />

APPEND Defines a pipeline that runs after other stages are complete. APPEND 27<br />

BETWEEN Divides message streams into sections. BETWEEN 29<br />

CASEI Compares character strings without respect to case. CAS 31<br />

CHANGE Replaces occurrences of one string with another. CHAN 33<br />

CHOP Truncates lines after a specified character, column, or string. CHOP 37<br />

COLLECT Creates a multiline message, or messages, from input lines. COL 39<br />

CONSOLE Displays the contents of the pipeline. CON 44<br />

COREVENT Extracts in<strong>for</strong>mation from messages <strong>for</strong> state correlation. COREVENT 47<br />

COREVTDA Takes messages with event data, creates new MWLTO<br />

messages from the input stage, and places them on the<br />

secondary output stream.<br />

COREVTDA 49<br />

CORRCMD Runs commands and adds timer and termination stages. CC 50<br />

CORRWAIT Allows asynchronous messages into the pipeline. CORR, WAIT 54<br />

COUNT Counts the number of messages, lines, or bytes in the input<br />

stream.<br />

COUNT 59<br />

CPDOMAIN Converts control point (CP) names to <strong>NetView</strong> domain<br />

names.<br />

CPD 63<br />

DELDUPES Deletes duplicate messages. DELDUP 68<br />

DIVERT Routes primary input to primary or secondary output. DIVERT 71<br />

24 <strong>Programming</strong>: <strong>Pipes</strong>

Hooray! Your file is uploaded and ready to be published.

Saved successfully!

Ooh no, something went wrong!