ODBC プログラムでのグローバル・トランザクション

グローバル・トランザクションとは、リカバリー可能な作業単位、またはトランザクションです。 このトランザクションは複数リソースのコレクションに対する変更により構成されています。アプリケーションにグローバル・トランザクションを組み込み、 単一トランザクションのコンテキストで、複数のリカバリー可能リソースをアクセスします。

グローバル・トランザクションによって、2 フェーズ・コミット処理に関わるアプリケーション を作成することができます。 グローバル・トランザクションに関わるすべてのリソースは、アトミック単位として、 コミットされるか、ロールバックされることが保証されます。z/OS® Transaction Management および Resource Recovery Services (RRS) は、2 フェーズ・コミット・プロトコルを使用することによって、 グローバル・トランザクション内で生じる更新を整合させます。

グローバル・トランザクションを使用可能にするには、キーワード AUTOCOMMIT=0、MULTICONTEXT=0、 および MVSATTACHTYPE=RRSAF を初期化ファイルで指定します。

グローバル・トランザクションを使用するには、RRS API を含む以下のアクションを アプリケーションで実行します。
  1. ATRSENV() を呼び出し、接続ハンドルを割り振る前に、RRS に対して環境設定値を指定します。
  2. ATRBEG() を呼び出し、グローバル・トランザクションの開始境界点を明確にします。
  3. グローバル・トランザクションの一部であるリソースを更新します。
  4. SRRCMIT()、SRRBACK()、または RRS サービス ATREND() を呼び出し、 グローバル・トランザクションの終了境界点を明確にします。
  5. アプリケーションに組み込むそれぞれのグローバル・トランザクションごとに、 ステップ 2 およ び 4 を繰り返します。

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 );