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

Create successful ePaper yourself

Turn your PDF publications into a flip-book with our unique Google optimized e-Paper software.

Chapter 8. Debugging <strong>NetView</strong> Pipelines<br />

If your pipelines are not functioning, there are several things that you can do to<br />

identify the source of the problem. The pipeline processor examines your pipeline<br />

specification <strong>for</strong> syntax errors, be<strong>for</strong>e attempting to run it. When the processor<br />

finds syntax errors, it displays error messages.<br />

Understanding Error Messages<br />

Online Help<br />

Pipeline error messages do not display the name of a failed stage; instead, error<br />

messages provide the position of the failed stage in the pipeline specification. If<br />

there are multiple syntax errors, the processor displays an error message <strong>for</strong> the<br />

first syntax error found. When that error is corrected, the processor examines the<br />

specification <strong>for</strong> any additional syntax errors.<br />

For example, an operator enters:<br />

PIPE NETVIEW CL<strong>OS</strong>E IMMED | CONSOOOLE<br />

The command contains the two stages, NETVIEW and CONSOLE (which is<br />

misspelled). The pipeline processor finds the syntax error and displays messages to<br />

the console as shown below. Notice that although the DWO362E message does not<br />

name the CONSOLE stage, it does indicate that an error was found in the second<br />

stage specification in the PIPE command, thus pointing to the CONSOLE stage.<br />

NCCF NETVIEW CNM01 OPER6 03/20/10 12:15<br />

* CNM01 PIPE NETVIEW CL<strong>OS</strong>E IMMED | CONSOOOLE<br />

- CNM01 DWO364E PIPELINE TERMINATED. NO STAGE CONSOOOLE EXISTS.<br />

- CNM01 DWO362E PIPELINE TERMINATED. ERROR IN STAGE 2 IN PIPELINE ’PIPE’.<br />

Note: Stage names inserted with the INTERPRT stage always have a stage number<br />

greater than 10 000. The CL<strong>OS</strong>E IMMED command did not run because the<br />

pipeline did not start. See “PIPE INTERPRT ” on page 143 <strong>for</strong> more<br />

in<strong>for</strong>mation.<br />

To display online help <strong>for</strong> the pipe command, enter:<br />

HELP PIPE<br />

To display online help <strong>for</strong> a specific stage, enter:<br />

HELP PIPE stage_name<br />

Where:<br />

stage_name<br />

is any <strong>NetView</strong> PIPE stage.<br />

See Chapter 2, “Pipeline Stages and Syntax,” on page 19 <strong>for</strong> a list of stages<br />

supported by the NETVIEW PIPE command.<br />

© Copyright <strong>IBM</strong> Corp. 1997, 2011 345

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

Saved successfully!

Ooh no, something went wrong!