To send a generic alert, use request code 12. There is no special PPI setup required to do this.
The following RPB fields must be set up before the call:
|
Bytes |
Field Name |
Set to... |
|
00-03 |
RPLEN |
56 |
|
04-05 |
REQUEST |
12 |
|
06-07 |
RECOPT |
as required |
|
12-15 |
WORKADDR |
address of 128 byte work area |
|
32-35 |
BUFFLEN |
length of the generic alert data |
|
36-39 |
BUFFADDR |
address of the generic alert data |
The following RPB Fields are returned after the call:
|
Bytes |
Field Name |
Set to... |
|
08-11 |
RETCODE |
see below |
The following return codes are possible:
Request completed successfully
The ALERT receiver task (NETVALERT) is not active-the alert has been queued
The requestor is not in primary addressing mode
PPI is not active
The NETVALERT receiver program is not defined
PPI requests are not supported
No storage available
Invalid buffer length
Alert receiver buffer queue full
ESTAE could not be established as requested
Invalid sender ID
A processing error occurred
Note: The generic alert must include the 8-byte NMVT header.
The default buffer queue limit for the alert receiver is 1000 generic alerts.
A return code of 22 or greater means that the alert has not been copied to the alert receiver queue.
If no hierarchy/resource list sub vector is provided in the generic alert, the sender-ID is used as the resource name.
PPI does not release the data buffer storage. Your program must do this if required.