28.11.2012 Views

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

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

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

SHOW MORE
SHOW LESS

Create successful ePaper yourself

Turn your PDF publications into a flip-book with our unique Google optimized e-Paper software.

PIPE PPI<br />

Syntax<br />

PPI Sender:<br />

PPI<br />

PPI Receiver:<br />

(DATAONLY)<br />

(TECROUTE)<br />

(TECRTCFM)<br />

(TRAPROUT)<br />

(MLWTO)<br />

(NV)<br />

receiver_name<br />

*<br />

PPI receiver_name<br />

(APONLY)<br />

PPI Requestor:<br />

PPI receiver_name /string/<br />

(APONLY)<br />

Command Description<br />

The program-to-program interface (PPI) stage communicates with another address<br />

space in the same host using the <strong>NetView</strong> program-to-program interface. PPI can<br />

be used in three ways:<br />

v Sender<br />

v Receiver<br />

v Requestor<br />

When PPI has an input stream, PPI acts as a sender. The data received on the<br />

input stream is passed to the receiver specified by receiver_name.<br />

If PPI does not have an input stream, PPI acts as a receiver. The receiver_name<br />

specifies the name where data must be sent to be processed by the PPI stage.<br />

PIPE PPI<br />

When acting as a receiver, follow the PPI with CORRWAIT * so data can be received<br />

continuously without deactivating the receiver. If the receiver is deactivated, even<br />

<strong>for</strong> a short time, senders might encounter errors.<br />

Note: When PPI is used as a receiver, the pipe option LOWQENAB is in effect<br />

even if not explicitly specified. See “PIPE (NCCF) ” on page 20 <strong>for</strong> more<br />

in<strong>for</strong>mation about LOWQENAB.<br />

When a /string/ is specified, PPI acts as a requestor. The /string/ is sent to the<br />

receiver specified by receiver_name and PPI waits <strong>for</strong> a response. A receiver name is<br />

automatically generated to receive the response.<br />

Chapter 2. Pipeline Stages and Syntax 187

Hooray! Your file is uploaded and ready to be published.

Saved successfully!

Ooh no, something went wrong!