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

Usage Notes
PIPE PPI
When PPI is used as a sender, receiver_name can also be an asterisk (*). Asterisk
indicates that the message is to be returned to the program originating the
message. The originating message is identified by the sender message attribute
(IFRAUSDR).
APONLY
Specifies that messages are accepted only from an APF authorized program.
DATAONLY
Specifies that only the data portion of each line is sent. NetView buffer headers
and structures are not sent. DATAONLY is only valid when PPI is used as a
sender.
MLWTO
Specifies that the message receiver can receive messages formatted to NetView
multiline message standards. Messages are sent as a NetView multiline
message unit. MLWTO is only valid when PPI is used as a sender.
NV Specifies that the receiver is another NetView. Multiline messages and
attributes are sent to the receiver who reconstructs them into a multiline
message.
TECROUTE
Specifies that the message or alert is to be formatted and transferred to the
Event/Automation Service associated with the named PPI receiver. The
message is converted by the Event/Automation Service into an Event
Integration Facility (EIF) event and sent to the server.
TECRTCFM
Specifies that the message or alert is to be formatted and transferred to the
Event/Automation Service associated with the named PPI receiver. The
message or alert is converted by the Event/Automation Service into an an
Event Integration Facility (EIF) event and sent to a server. The
Event/Automation Service expects the server to send a reply confirming or
rejecting the EIF event.
TRAPROUT
Specifies that the alert is to be formatted and transferred to the
Event/Automation Service associated with the named PPI receiver. The alert is
converted by the Event/Automation Service into a trap and sent to the SNMP
manager. Note that text messages are not supported by TRAPROUT.
/string/
A delimited character string to be sent to the receiver specified by
receiver_name.
v It is imperative, when passing an alert to the alert adapters, to send the entire
original alert. Additions to the alert can be made using the NAMEBIND EDIT
order. Deletions or other changes to the alert can cause the message to be
unrecognized as an alert by the alert adapters.
v When sending messages to another NetView system, the NV option preserves all
message attributes except the cross domain sender name.
v When PPI is used as a requestor, two return codes can be output to the
secondary output stream: the first results from sending the request, the second
from receiving the response. When the send fails, the receive is canceled and
only the return code from the send is passed to the secondary output. When the
receiving session cannot be established, only the receive initialization failure
Chapter 2. Pipeline Stages and Syntax 189