Alert APIs

The alert APIs let your application create alerts, notify the i5/OS^(TM) alert manager of alerts that need to be handled, and allow you to retrieve alerts and alert data. The generate and send APIs differ from ordinary i5/OS alert processing in that they let your application create an alert at any time without sending an alertable message to an alertable message queue. (An alertable message queue is a message queue that has been created or changed with the allow alerts (ALWALR) parameter specified as yes.) The retrieve API allows your application, in conjunction with alert filtering, to perform user-defined actions based on the contents of the alert.

For more information on creating and sending i5/OS alerts, see the Alerts Support book.

The alert APIs are:

• Generate Alert (QALGENA) creates an alert for a particular message ID.
• Retrieve Alert (QALRTVA) retrieves an alert from the alert database.
• Send Alert (QALSNDA) sends an alert to the i5/OS alert manager for processing.