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

PIPE PPI
190 Programming: Pipes
code is returned. See the IBM Tivoli NetView for z/OS Application Programmer's
Guide for more information about PPI return codes.
v The PPI stage is not supported under the PPT task.
v When PPI is used as a requestor, the PPI stage chooses a receiver name that is
used to receive a reply. The name chosen is in the form aa#xxxxx where aa is the
system default defined by the PPIPREFX keyword on the DEFAULT command
and xxxxx is a value dynamically chosen at run time. For more information
about PPIPREFX, see IBM Tivoli NetView for z/OS Command Reference Volume 1
(A-N).
If an error is detected in the PPI prefix, a return code is passed to the secondary
stream. If a secondary stream is not defined, message DWO411I is issued with
the incorrect PPI prefix.
v Access to PPI functions can be controlled using SAF or the NetView Security
Table.
Security checking is done for the pseudo-keywords RECEIVE and SEND on a
DSIPIPPI command. The SEND pseudo-keyword controls both the sender and
requestor functions of PPI.
The SEND and RECEIVE pseudo-keywords correspond to the PPI receiver_name
specified on the PPI stage.
To prohibit using:
PIPE PPI GEORGE | WAIT ...
Code the following PROTECT statement:
PROTECT *.*.DSIPIPPI.RECEIVE.GEORGE
To prohibit using:
PIPE LITERAL /STUFF/ | PPI SAM ...
Code the following PROTECT statement:
PROTECT *.*.DSIPIPPI.SEND.SAM
Return Codes
The following return codes are returned by the PPI stage as signed, 10-digit
decimal numbers:
Return Code Meaning
0 PPI completed successfully.
100 A system abend occurred during a PPI service send or receive. This
might be a forced closure of the PPI address space.
104 A user abend occurred during a PPI service send or receive. See
the IBM Tivoli NetView for z/OS Application Programmer's Guide for
more information about user abends.
1001 The AIFR or the input length was not valid.
1002 Did not identify the data as a message or MSU.
1003 An incomplete multiline message was discarded by the PPI stage
because of the receipt of an unrelated message from the same
sender.
1004 An illegal alert forwarding loop was detected. The NetView
program attempts to avoid loops by not forwarding alerts back to
their source. Specifically, PPI (TECROUTE) or PPI (TECRTCFM) is
not valid for a generic alert whose subvector X'92', flag bit 7, is on