Send a Data Buffer to a Receiver

Program-to-Program Interface › Control Data Buffers › Send a Data Buffer to a Receiver

Send a Data Buffer to a Receiver

To send a data buffer to a receiver program, use request code 14. The receiver program does not need to be active. As long as its buffer queue limit is not exceeded, the data buffer is queued to it.

The RPB fields in the following table must be set up before the call:

Bytes	Field Name	Set to...
00–03	RPLEN	56.
04–05	REQUEST	14.
06–07	RECOPT	A recovery option as required.
12–15	WORKADDR	The address of a 128-byte work area.
16–23	SENDERID	A valid sender ID.
24–31	RECVERID	The target receiver ID.
32–35	BUFFLEN	The length of the data buffer to send.
36–39	BUFFADDR	The address of the data buffer to send.

The RPB field in the following table is returned after the call:

Bytes	Field Name	Set to...
08–11	RETCODE	The return code.

The following return codes are possible:

0: Request completed successfully.
4: The specified receiver is not active-the buffer has been queued.
22: The requestor is not in primary addressing mode.
23: The sender program is not authorized.
24: PPI is not active.
26: The receiver program is not defined.
28: PPI requests are not supported.
32: No storage is available.
33: Buffer length is invalid.
35: The receiver buffer queue is full.
36: ESTAE could not be established as requested.
40: Sender ID is invalid.
90: A processing error occurred.

Notes:

If sending a buffer to a receiver defined as authorized, the sender must be APF authorized.
After the call the data buffer is queued to the nominated receiver.
The PPI does not release the data buffer storage. Your program must release the storage if necessary.