To check the status of PPI, use request code 1. This allows an application program to inquire about the status of the PPI facility. The return code indicates whether it is active or not.
The following RPB fields must be set:
|
Bytes |
Field Name |
Set to... |
|
00-03 |
RPLEN |
56 |
|
04-05 |
REQUEST |
1 |
|
12-15 |
WORADDR |
address of 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 following RPB fields are returned after the call:
|
Bytes |
Field Name |
Contains |
|
08-11 |
RETCODE |
see below |
|
48-51 |
VERSION |
The PPI version number is RETCODE 10 is returned. F'1' indicates Tivoli NetView 2.4. F'0' indicates a prior release. |
The following return codes are possible:
PPI is active and available to process requests
PPI is not active
PPI requests are not supported
A processing error occurred