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

PIPE UNIX
PIPE UNIX
Syntax
UNIX:
UNIX
(ECHO) unix_command
Command Description
The PIPE UNIX stage transfers a command to a NetView UNIX server where the
command is executed and the results returned. Specify CORRWAIT to follow
UNIX to enable the return of command responses.
Streams
Commands can be passed on the stage or on the input stream.
Stream Type Number Supported
Input 1
Output 3
Termination Conditions
UNIX terminates when the input stream and the primary output stream are
disconnected. If UNIX is followed by CORRWAIT, CORRWAIT automatically ends
when the UNIX command completes and the response has been received.
Operand Descriptions
Usage Notes
246 Programming: Pipes
ECHO
Write the command to the primary output stream prior to the execution of the
command.
unix_command
A UNIX line mode command to be invoked at the UNIX server. Unix_command
is required when UNIX has no input stream and is otherwise optional.
If unix_command is specified, the command is invoked once if the UNIX stage
has an input stream. Otherwise, the command is invoked when an input
message is passed to the UNIX stage.
If unix_command is not specified, the commands to be invoked are read from
the input stream.
v Command authority is checked prior to and after submitting the command.
Prior to submission authority is checked for the pipe stage, but no checking is
done of the UNIX command. To permit only BOSS to use the UNIX stage, code
the following:
PROTECT *.*.DSIPIUNX
PERMIT BOSS *.*.DSIPIUNX