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

Debugging NetView Pipelines
348 Programming: Pipes
Displaying Data Stream Information (DEBUG)
The DEBUG option generates information about the input and output data streams
in a pipeline. DEBUG can be used either as a pipeline option, affecting the entire
pipeline, or on individual stages.
Attention:
v DEBUG output is provided for pipeline problem determination only and is not
intended as a programming interface. The format, type, and amount of
information provided by DEBUG is subject to future change.
v DEBUG information is available in English only.
DEBUG Stage Option
DEBUG on a stage generates information about input and output streams
connected to the stage and the messages flowing over those streams.
Consider the following pipeline.
/* REXX Example - Formats output from LIST STATUS=TASKS */
address NETVASIS,
’PIPE (NAME TASKLIST END -)’,
’| NETV LIST STATUS=TASKS’, /* generate the data */
’| DROP LAST 1’, /* no need of "END OF DATA" */
’| COLOR GREEN’, /* standardize buffers */
’| EDIT WORD 2 1’, /* reformat data from the lines */
’19.8 8’,
’38.8 19’,
’55.* 35’,
’| LABS: COLLECT’, /* data and labels, labels read first */
’| CONSOLE ONLY’, /* display results */
, /* --- END of simple pipeline, begin new pipeline... */
’- FAN: (DEBUG) FANIN’, /* feed data to "LABS", in order */
’| LABS:’,
, /* --- END of simple pipeline, begin new pipeline... */
’- LIT !-------- Status of NetView Tasks ---------!’,
’| COLOR YEL’, /* Control line becomes yellow */
’| FAN:’, /* give line to "FAN" (primary input) */
" LIT !Task Task’s Taskname or Current!",
’| COLOR PINK’, /* First label line becomes pink */
’| FAN:’, /* give line to "FAN" (2nd input) */
"- LIT !type ID Resource Status!",
’| COLOR PINK’, /* Second label line becomes pink. */
’| FAN:’ /* give line to "FAN" (3rd input) */
Note: For more information, see “Example: Formatting LIST STATUS=TASKS
Output” on page 42.
DEBUG on the stage labeled FAN: generates information about the data streams
connected to FANIN and the messages flowing on those data streams. The
following is an example of the type of problem determination information
produced.
Connecting output number 1 of stage 7, "FANIN "
to input number 2 of stage 5, "COLLECT ".
Connecting output number 1 of stage 9, "COLOR YEL "
to input number 1 of stage 7, "FANIN ".
Connecting output number 1 of stage 11, "COLOR PINK "
to input number 2 of stage 7, "FANIN ".
Connecting output number 1 of stage 13, "COLOR PINK "
to input number 3 of stage 7, "FANIN ".
Stage 7 reads input from stream 1, "Status of NetVi".
Stage 7 writes output to stream 1, "Status of NetVi".
Stage 7 reads input from stream 2, "Task Task’s ".