DataBlade API Programmer's Manual

DataBlade API Programmer's Manual
Chapter 9: Event and Exception Handling

Home Contents Index Master Index New Book

Events

An event is something that occurs in the database server or in a user-defined routine that might be of interest to an application. DataBlade API implements events for database server exceptions and transaction state changes, as well as a special event type that encompasses all events.

An event is classified as one of the enumerated types in the MI_EVENT_TYPE type definition in milib.h. The DataBlade API uses the associated structure for the event type, as the following table shows.

(1 of 2)

Event Type Description Associated Structure
MI_All_Events
Special all-events flag

MI_Exception
An exception (database server error or warning)
MI_ERROR_DESC

MI_Client_Library_Error
Client-side library errors
MI_ERROR_DESC

MI_Xact_State_Change
Transaction state change
MI_TRANSITION_DESC

MI_EVENT_END_STMT
End of a statement. If applied to a cursor, this event is not called until the cursor is closed implicitly by the database server (for example, when the cursor is reopened). Not called if the database server terminates abnormally. (server user-defined routines only)
MI_TRANSITION_DESC

MI_EVENT_END_SESSION
End of a session. Not called if the database server terminates abnormally (server user-defined routines only)
MI_TRANSITION_DESC

DataBlade API Programmer's Manual, version 9.1
Copyright © 1998, Informix Software, Inc. All rights reserved.