Informix DataBlade API Programmer's Manual DataBlade API Function Descriptions

The mi_xact_levels() routine sets into the address of the user-supplied integers the transaction level before and after the transition.

void mi_xact_levels(client_data, oldlevel, newlevel)

void *client_data;

mi_integer *oldlevel;

mi_integer *newlevel;

client_data	is a pointer to the type-specific structure passed to the callback by the API.
oldlevel	is a pointer to a user-supplied integer that is set to the pre-event transaction level. Possible values are 0 for an outside transaction and 1 for an inside transaction.
newlevel	is a pointer to a user-supplied integer that is set to the post-event transaction level. Possible values are 0 for an outside transaction and 1 for an inside transaction.

Valid in Client LIBMI Application?	Valid in User-Defined Routine?
Yes	Yes

Important: The DataBlade API provides this function only for backward compatibility with earlier Illustra applications. For new DataBlade API programs, use the mi_transition_type() function.

The mi_xact_levels() function is an accessor routine that you can use in a callback routine on notification of a transaction state transition; that is, entering or exiting a transaction.

Whenever the database server goes in or out of a transaction, the MI_Xact_State_Change event occurs. The two possible levels are 0 (not in a transaction) and 1 (in a transaction). The different statements set these levels as follows.

None.

See the description of the mi_xact_state() function.

For more information, see Creating a Callback Function.