DataBlade API Programmer's Manual

DataBlade API Programmer's Manual
Chapter 12: DataBlade API Function Descriptions

Home Contents Index Master Index New Book

mi_xact_levels()

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

Syntax

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 DataBlade 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 Application?

Valid in Server Routine?

Yes
Yes

Usage

Important: The DataBlade API provides this function only for backward compatibility.

This accessor routine is used 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.

Command Old Level New Level
BEGIN WORK
0
1

COMMIT WORK
1
0

ROLLBACK WORK
1
0

DataBlade API Programmer's ManualChapter 12: DataBlade API Function Descriptions Home Contents Index Master Index New Book

mi_xact_levels()

Syntax

Usage

Related Topics

DataBlade API Programmer's Manual
Chapter 12: DataBlade API Function Descriptions

Home Contents Index Master Index New Book