DataBlade® API event types

For a DataBlade® API module, an event is a communication from HCL Informix® software that indicates the existence of some predefined condition, usually the occurrence of an exception (warning or error). The DataBlade® API represents an event as one of the enumerated values of the MI_EVENT_TYPE data type.

The following table shows the MI_EVENT_TYPE values that the DataBlade® API supports.
Table 1. DataBlade® API event types
Event type When the event type occurs C UDR Client LIBMI application
MI_Exception Raised when the database server generates an exception (a warning or an error) Yes Yes
MI_EVENT_SAVEPOINT Raised after the cursor flushes within an explicit transaction Yes No
MI_EVENT_COMMIT_ABORT Raised when the database server reaches the end of a transaction in which work was done Yes No
MI_EVENT_END_XACT Raised when the database server reaches the end of a transaction, or if a hold cursor is involved, raised only after the hold cursor is closed

It is preferable to register the MI_EVENT_COMMIT_ABORT callback.

 Yes No
MI_EVENT_END_STMT Raised when the database server completes the execution of the current SQL statement, or for statements associated with a cursor, raised when the cursor is closed Yes No
MI_EVENT_POST_XACT Raised just after the database commits or rolls back a transaction if work was done in the transaction or if an MI_EVENT_END_XACT event was raised Yes No
MI_EVENT_END_SESSION Raised when the database server reaches the end of the current session Yes No
MI_Xact_State_Change Raised when the database server starts or ends a transaction, whether the transaction contains one or multiple SQL statements No Yes
MI_Client_Library_Error Raised when the client LIBMI library encounters an error No Yes
Important: MI_All_Events is a deprecated event type and is not listed with the MI_EVENT_TYPE values. Using the MI_All_Events event type is not recommended.
The milib.h header file defines the MI_EVENT_TYPE data type and its event types. The DataBlade® API event types can be grouped as follows.
Event type Event group More information
MI_Exception Database server exceptions Database server exceptions

MI_EVENT_SAVEPOINT
MI_EVENT_COMMIT_ABORT
MI_EVENT_POST_XACT
MI_EVENT_END_STMT
MI_EVENT_END_XACT
MI_EVENT_END_SESSION
MI_Xact_State_Change

 State-transition events State-transition events
MI_Client_Library_Error Client LIBMI errors Client LIBMI errors