Working with Events
Go Up to API Guide
This chapter describes how to work with events, a message passed from a trigger or stored procedure to an application to announce the occurrence of a specified condition or action, usually a database change such as an insertion, modification, or deletion of a record. It explains how to set up event buffers, and use the following API functions to make synchronous and asynchronous event calls. In the following table, functions are listed in the order they typically appear in an application:
| Function | Purpose |
|---|---|
|
|
Allocate event parameter buffers |
|
|
Wait for a synchronous event to be posted |
|
|
Set up an asynchronous event and return to application processing |
|
|
Determine the change in values of event counters in the event parameter buffer |
|
|
Cancel interest in an event |
For asynchronous events, this chapter also describes how to create an asynchronous trap (AST), a function that responds to posted events.
Topics
- Understanding the Event Mechanism
- Creating EPBs with isc_event_block( )
- Waiting on Events with isc_wait_for_event()
- Continuous Processing with isc_que_events()
- Determining Which Events Occurred with isc_event_counts()
- Canceling Interest With isc_cancel_events()