bea ホーム | 製品 | dev2dev | support | askBEA |
![]() |
![]() |
|
![]() |
e-docs > Tuxedo > Tuxedo CORBA プログラミング・リファレンス > TP フレームワーク |
Tuxedo CORBA プログラミング・リファレンス
|
概要
呼び出しプロセスのリンク先の XA リソース・マネージャをクローズします。
C++ バインディング
static void TP::close_xa_rm ();
引数
特にありません。
説明
close_xa_rm() メソッドは、呼び出しプロセスのリンク先の XA リソース・マネージャをクローズします。XA リソース・マネージャは、Oracle や Informix などのデータベース・ベンダから提供されます。
注記 この呼び出しの機能も、Tobj::TransactionCurrent::close_xa_rm() によって提供されます。TransactionCurrent オブジェクトのオブジェクト・リファレンスを取得する必要がないので、サーバ・アプリケーションでリソース・マネージャをクローズする方法としては、TP::close_xa_rm() メソッドを使う方がはるかに便利です。TransactionCurrent オブジェクトのリファレンスは、Bootstrap オブジェクトから取得できます。Bootstrap オブジェクトのリファレンスの取得方法については、「TP::bootstrap()」を参照してください。TransactionCurrent オブジェクトの詳細については、「CORBA ブートストラップ処理のプログラミング・リファレンス」と『BEA Tuxedo CORBA トランザクション』を参照してください。
グローバル・トランザクションに関与するサーバごとに Server::release() メソッドから 1 回、このメソッドを呼び出す必要があります。グローバル・トランザクションに関与しているすべてのサーバだけでなく、XA リソース・マネージャにリンクされたサーバも含まれますが、XA 準拠のリソース・マネージャに実際にはリンクされていません。
close_xa_rm() メソッドは、リソース・マネージャに固有のクローズ呼び出しの代わりに呼び出します。リソース・マネージャの初期化セマンティクスはそれぞれ異なるので、特定のリソース・マネージャをクローズするための情報を、BEA Tuxedo システムの UBBCONFIG ファイルの GROUPS セクションにある CLOSEINFO パラメータに指定します。
CLOSEINFO 文字列の形式は、基となるリソース・マネージャのデータベース・ベンダごとに異なります。CLOSEINFO パラメータの詳細については、『BEA Tuxedo アプリケーションの設定』と『BEA Tuxedo のファイル形式とデータ記述方法』の「ubbconfig(5)」のリファレンス・ページを参照してください。また、XA ライブラリを使用するアプリケーションの開発およびインストール方法については、データベース・ベンダのマニュアルを参照してください。
戻り値
特にありません。
例外
注記 TP フレームワークのその他の例外と違い、Tobj::RMFailed 例外は、TobjS_c.h (TobjS.idl から派生) ではなく、tobj_c.h (tobj.idl から派生) で定義されます。これは、ネイティブ・クライアントでも XA リソース・マネージャをオープンできるからです。したがって、返される例外は、ネイティブ・クライアント・コードおよび Server::release() (ネイティブ・クライアントと共有される代替メカニズムである TransactionCurrent::close_xa_rm を使用している場合) で想定される例外と一致します。
![]() |
![]() |
![]() |
![]() |
||
![]() |
![]() |
![]() |
![]() |
![]() |
![]() |
![]() |