ODBC プログラムでのグローバル・トランザクション
グローバル・トランザクションとは、リカバリー可能な作業単位、またはトランザクションです。 このトランザクションは複数リソースのコレクションに対する変更により構成されています。アプリケーションにグローバル・トランザクションを組み込み、 単一トランザクションのコンテキストで、複数のリカバリー可能リソースをアクセスします。
グローバル・トランザクションによって、2 フェーズ・コミット処理に関わるアプリケーション を作成することができます。 グローバル・トランザクションに関わるすべてのリソースは、アトミック単位として、 コミットされるか、ロールバックされることが保証されます。z/OS® Transaction Management および Resource Recovery Services (RRS) は、2 フェーズ・コミット・プロトコルを使用することによって、 グローバル・トランザクション内で生じる更新を整合させます。
グローバル・トランザクションを使用可能にするには、キーワード AUTOCOMMIT=0、MULTICONTEXT=0、 および MVSATTACHTYPE=RRSAF を初期化ファイルで指定します。
グローバル・トランザクションを使用するには、RRS API を含む以下のアクションを
アプリケーションで実行します。
SQLEndTran() は、それぞれのグローバル・トランザクションの範囲内で使用不可になりますが、 依然として、この関数を使用して、グローバル・トランザクションの境界範囲外にある ローカル・トランザクションをコミットしたり、ロールバックすることができます。
Db2® ODBC は、ストアード・プロシージャーの下で稼働するアプリケーションの グローバル・トランザクション処理をサポートしません。
以下の例
は、グローバル・トランザクション処理を
使用するアプリケーションを示しています。このアプリケーションでは、ODBC および RRS の両方の API を使用して、2 つのリソースでの
グローバル・トランザクションを作成します。
図 1. ODBC グローバル・トランザクションを実行するアプリケーション
/* Provide environmental settings for RRS */
ATRSENV();
/* Get an environment handle (henv) */
SQLAllocHandle(SQL_HANDLE_ENV, SQL_NULL_HANDLE, &henv);
/* Get a connection handle (hdbc1) */
SQLAllocHandle(SQL_HANDLE_DBC, henv, &hdbc1);
/* Get a connection handle (hdbc2) */
SQLAllocHandle(SQL_HANDLE_DBC, henv, &hdbc2);
/* Start a global transaction */
ATRBEG( ... , ATR_GLOBAL_MODE , ... );
/* Connect to STLEC1 */
SQLConnect( hdbc1, "STLEC1", ... );
/* Execute some SQL with hdbc1 */
SQLAllocHandle(SQL_HANDLE_STMT, hdbc1, &hstmt1);
SQLExecDirect( hstmt1, ... );
SQLExecDirect( hstmt1, ... );
.
.
/* Connect to STLEC1B */
SQLConnect( hdbc2, "STLEC1B", ... );
/* Execute some SQL with hdbc2 */
SQLAllocHandle(SQL_HANDLE_STMT, hdbc2, &hstmt2);
SQLExecDirect( hstmt2, ... );
SQLExecDirect( hstmt2, ... );
.
.
/* Free statement handles */
SQLFreeHandle(SQL_HANDLE_STMT, hstmt1);
SQLFreeHandle(SQL_HANDLE_STMT, hstmt2);
/* Commit global transaction */
SRRCMIT();
/* Start a global transaction */
ATRBEG( ... , ATR_GLOBAL_MODE , ... );
/* Execute some SQL with hdbc1 */
SQLAllocHandle(SQL_HANDLE_STMT, hdbc1, &hstmt1);
SQLExecDirect( hstmt1, ... );
SQLExecDirect( hstmt1, ... );
.
.
/* Execute some SQL with hdbc2 */
SQLAllocHandle(SQL_HANDLE_STMT, hdbc2, &hstmt2);
SQLExecDirect( hstmt2, ... );
SQLExecDirect( hstmt2, ... );
.
.
/* Commit global transaction */
ATREND( ATR_COMMIT_ACTION );
/* Disconnect hdbc1 and hdbc2 */
SQLDisconnect( hdbc1 );
SQLDisconnect( hdbc2 );