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

PIPE CORRCMD
v When RMTCMD or service point stages are entered using CORRCMD,
termination conditions are inherent in the stage. Other termination conditions
defined by CCDEF are redundant.
v When the target stage (following the RMTCMD label syntax) is PIPE, the
CORRCMD stage does not force output to be collected into one multiline
message. You can add a COLLECT stage to your pipeline specification for better
performance.
v When you use the RMTCMD label syntax to transfer stages to a NetView V2R3
domain, the target command must be PIPE. However, you can use the pipeline
to run other stages. See “PIPE NETVIEW ” on page 167 for a list of some
commands for which command and response correlation is supported.
Return Codes
The following return codes are valid only when the MOE operand is used.
Examples
52 Programming: Pipes
Return Code Meaning
-4 Installation exit 03 generated USERDROP.
-500 to -599 Failure attempting to call installation exit 03. Report specific return
code to the IBM Software Support.
-108 Stage is type=I or type=P.
-112 Stage search failed. This is usually because the stage is too long.
-116 ACCESS not authorized. Command authorization restrictions
prevent processing.
-120 Command is type=D.
There are other possible return codes indicating storage failure. The code you get
depends upon the processing phase when storage failure was detected. Look for
DSI124I at the system console for this condition.
Example: Issuing a VTAM Command
To issue the VTAM stage D NET,APPLS, trap the resulting messages, and display
them, enter:
PIPE CORRCMD D NET,APPLS
| CONSOLE
Example: Issuing a Command to the Remote Domain
To transfer a VARY stage to a remote domain (by the RMTCMD stage) and to
arrange the timer and termination condition stages at both the local and remote
domains, enter:
PIPE CORRCMD CNM18: VARY NET,ACT,ID=XYZ
| CONSOLE ONLY
Response
v At the local domain:
– An appropriate wait time for the RMTCMD stage is arranged.
v At the remote domain (CNM18):
– The VARY stage is run.
– An appropriate wait time for the response to the stage is arranged.
– The wait is terminated when the expected response is received.