Previous Topic: Sample PPI Calls

Next Topic: Control Receiver Programs

Check PPI Status

To check the status of PPI, use request code 1. This request code allows an application program to inquire about the status of the PPI facility. The return code indicates whether it is active or not.

The RPB fields in the following table must be set:

Bytes

Field Name

Set to...

00–03

RPLEN

56.

04–05

REQUEST

1.

12–15

WORADDR

The address of a 128-byte work area.

46

REQIND1

Bit 1(X'40') if you want the PPI version returned.

48–51

VERSION

Binary 0 so that a back-level PPI can be detected correctly.

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

Bytes

Field Name

Contains

08–11

RETCODE

The return code.

48–51

VERSION

The PPI version number if RETCODE 10 is returned. F'1' indicates Tivoli NetView 2.4. F'0' indicates a prior release.

The following return codes are possible:

10

PPI is active and available to process requests.

24

PPI is not active.

28

PPI requests are not supported.

90

A processing error occurred.