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.

Usage Notes<br />

PIPE CORRCMD<br />

Usage note: Commands queued to the task running the pipe (such as with a<br />

null label) are run at high priority because they must interrupt the<br />

pipe itself. There<strong>for</strong>e, subsequent commands invoked using the<br />

same CORRCMD pipe stage (when the CORRCMD stage is not a<br />

first stage) might interrupt previous commands. If command<br />

procedures are queued by the CORRCMD stage using a null label<br />

and if any procedure invokes the UNIQUE command, then one or<br />

more procedures can be unexpectedly affected by the UNIQUE<br />

processing. See the description of the UNIQUE command in the<br />

<strong>IBM</strong> <strong>Tivoli</strong> <strong>NetView</strong> <strong>for</strong> z/<strong>OS</strong> Customization Guide <strong>for</strong> more<br />

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

cmdtext<br />

Specifies the command to be processed. If cmdtext consists of a label only and<br />

CORRCMD is not the first stage, then CORRCMD routes commands in the<br />

input stream as specified by the label. Such commands cannot contain a <strong>for</strong>m<br />

feed character ('OC'X) unless the command being routed is PIPE.<br />

Note: A PIPE command can contain any character. If your command contains<br />

the <strong>for</strong>m feed character ('OC'X), embed the command in a PIPE. For<br />

example,<br />

yourlabel: PIPE CORRCMD cmd with<br />

possible ff chars | CONS ONLY<br />

CGI<br />

Use the CGI option <strong>for</strong> a command that is able to produce either a 3270<br />

display or HTML, to in<strong>for</strong>m the command that HTML is preferred. The direct<br />

effect of the CGI option is on the REXX function, CGI(), and causes the<br />

function to return a value of 1. CGI cannot be specified with ECHO.<br />

ECHO<br />

When ECHO is specified, the text of the command itself is written to the<br />

pipeline be<strong>for</strong>e the command is executed. ECHO cannot be specified with CGI.<br />

MOE<br />

Message on error (MOE) examines the return code from the stage. If the return<br />

code is not zero, it inserts message DWO369I containing the return code into<br />

the stream after any messages the stage might have returned. The return codes<br />

in the message are from either the command or the implied wait. If you do not<br />

specify MOE, return codes from stages are ignored.<br />

NOPANEL<br />

When NOPANEL is specified, the stage is not allowed to display a full-screen<br />

panel. If it attempts to do so, message BNH113W is inserted into the pipeline<br />

and the stage receives an I/O error code from <strong>NetView</strong> presentation services.<br />

number<br />

Optional first argument is a timeout override.<br />

If the first token following CORRCMD is numeric, it is interpreted as a new<br />

specification of timeout which overrides the value specified <strong>for</strong> the stage by<br />

CCDEF. Valid values are 1-10000000. The default value is 60, unless another<br />

value is defined with CCDEF.<br />

v The timeouts and termination conditions to be used are defined by the customer<br />

using the CCDEF stage.<br />

Chapter 2. Pipeline Stages and Syntax 51

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

Saved successfully!

Ooh no, something went wrong!