Program-to-Program Interface › Control Receiver Programs › Delete an Active Receiver

Previous Topic: Deactivate a Receiver

Next Topic: Send a Generic Alert

Delete an Active Receiver

To delete an active receiver program, use request code 10. Any unreceived data buffers are purged.

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

10.

06–07

RECOPT

A recovery option as required.

12–15

WORADDR

The address of a 128-byte work area.

16–19

ASCBADDR

The address of the current ASCB (can be obtained by a request type 3).

24–31

RECVERID

The receiver ID.

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—the receiver has been deleted.

15

The receiver program is already inactive.

22

The requestor is not in primary addressing mode.

24

PPI is not active.

25

The ASCB address is not correct.

26

The receiver program is not defined.

28

PPI requests are not supported.

36

ESTAE could not be established as requested.

40

Receiver ID is invalid.

90

A processing error occurred.

Note: Only the owning task or address space can explicitly delete a receiver.