Previous Topic: &PPI Verb

Next Topic: Determining PPI or Receiver Status


Return Codes, System and User Variables

After each execution of the &PPI verb, the &RETCODE and &ZFDBK system variables are set to indicate the success, or otherwise, of the request. &ZFDBK is the PPI return code, and the &RETCODE is returned by the &PPI verb. The following table shows the correlation between the values in these variables.

Note: For more information about &RETCODE and &ZFDBK, see the Network Control Language Programming Guide.

The following table shows the correlation between the &ZFDBK and &RETCODE system variables.

&ZFDBK

&RETCODE

 

00

00

The PPI request completed successfully

04

04

The specified receiver is not active—the data buffer or generic alert has been queued

10

00

The PPI facility is active and can be used

14

00

The receiver program is active

15

04

The receiver program is already inactive

16

08

The receiver program is already active

18

12

The receiver ECB is not zero

20

12

Invalid request type

22

12

The program issuing this request is not executing in primary addressing mode

23

08

The user program is not authorized

24

12

PPI is not active

25

12

The ASCB address is not correct

26

08

The receiver program is not defined

28

12

This product release does not support PPI

30

04

No data buffer in the receiver buffer queue

 

20

&PPI RECEIVE WAIT=NOTIFY—no data buffers in queue, notify is queued

31

12

The receiver data buffer length is too short to receive the next data buffer

32

12

No storage is available

33

12

Invalid buffer length

35

08

The receiver buffer queue is full

36

12

Unable to establish ESTAE protection as requested

40

12

Invalid sender ID or receiver ID

90

12

A processing error has occurred

Other system variables are:

&ZPPI

Indicates whether this system appears to support PPI or not.

&ZPPINAME

Contains the PPI receiver ID that this NCL process is registered as.

Some &PPI functions set specific NCL user variables:

&PPISENDERID

Contains the PPI ID of the sender of a received message.

&PPIDATALEN

Contains the length of the actual received data in bytes.