Check the Status of a Receiver Program

Program-to-Program Interface › Control Receiver Programs › Check the Status of a Receiver Program

Check the Status of a Receiver Program

To check the status of a receiver program, use request code 2. The return code from this request indicates whether the receiver is defined, active, or inactive.

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	2.
12–15	WORADDR	The address of a 128-byte work area.
24–31	RECVERID	The name of the receiver you want to query.

The RPB fields in the following table are returned after the call:

Bytes	Field Name	Contains
08–11	RETCODE	The return code.
34	FLAG	The status of the receiver queue (for RETCODE 14 and 15). Bit 0 is set if there is space on the receiver queue or cleared if the receiver queue is full.

The following return codes are possible:

14: The receiver program is active.
15: The receiver program is not active.
22: The requestor is not in primary addressing mode.
24: PPI is not active.
26: The receiver program is not defined.
28: PPI requests are not supported.
90: A processing error occurred.

Tell Technical Publications how we can improve this information