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

UNIX commands are submitted under the UNIX user name equivalent to the
NetView operator ID. The command is checked for authorization by UNIX
according to the same rules that apply when the UNIX user name is directly
logged-on.
v When UNIX has an input stream, the command to be executed is read from the
input stream. The message input to the UNIX stage at the time the UNIX
command is scheduled is passed to the UNIX server for execution.
When the input is a multiline message, the input data is available to the target
command on its primary input.
v A secondary output stream can be connected to receive command response
codes. See “Return Codes” for information on codes passed to this stream.
If a tertiary stream is connected, message DSI037I is written to the tertiary
stream. Message DSI037I contains the UNIX process ID created for each
command.
Note: DSI037I is logged even if a tertiary stream is not defined.
PIPE UNIX
Return Codes
A secondary output stream can be connected to receive command response codes.
Each code begins with a 10-digit, 0-padded, signed number. Nonzero codes
indicate an error and are followed by a space and keyword indicating the source of
the error such as +0000000100 PPI.
The keyword can be one of the following:
PPI An error occurred connecting to the NetView program-to-program interface
or when sending the command to the destination.
+0000000100
Indicates a system abend occurred within PPI processing. This can
occur when the Program-to-Program interface is canceled.
+0000000104
Indicates that a user abend occurred in PPI processing.
For information about other codes, see the IBM Tivoli NetView for
z/OS Application Programmer's Guide.
UNIX An error occurred in UNIX operations supporting the command
invocation. Immediately following the response code are the rc, retval,
errno, and errnojr specific to the UNIX error. The format of the UNIX
response code is −0000000000 UNIX rc, retval, errno, errnojr. For more
information about these codes, refer to the MVS OpenEdition library.
−0000000001
Indicates that an attempt was made to run the UNIX server in a
non-UNIX/390 REXX environment.
−0000000002
Indicates that an unsuccessful call was made to DSIPHONE.
−0000000003
Indicates that the UNIX command failed.
−0000000004
Indicates that the server is unable to spawn child processes. The
UNIX server terminates.
Chapter 2. Pipeline Stages and Syntax 247