Home | Previous Page | Next Page   Database Access > Handling Exceptions and Events >

DataBlade API Event Types

For a DataBlade API module, an event is a communication from IBM 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. Table 66 shows the MI_EVENT_TYPE values that the DataBlade API supports.

Table 66. DataBlade API Event Types
Event Type Occurrence Where Event 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
Home | [ Top of Page | Previous Page | Next Page | Contents | Index ]