bea ホーム | 製品 | dev2dev | support | askBEA
BEA Logo Tuxedo
 ドキュメントのダウンロード   サイトマップ   用語集 
検索
0

Tuxedo CORBA プログラミング・リファレンス

 Previous Next Contents View as PDF  

TP::close_xa_rm()

概要

呼び出しプロセスのリンク先の 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 ライブラリを使用するアプリケーションの開発およびインストール方法については、データベース・ベンダのマニュアルを参照してください。

戻り値

特にありません。

例外

CORBA::BAD_INV_ORDER

アクティブなトランザクションがあります。トランザクションがアクティブになっている場合、リソース・マネージャをクローズすることはできません。

Tobj::RMFailed

tx_close() 呼び出しによって、エラー戻りコードが返されました。

注記 TP フレームワークのその他の例外と違い、Tobj::RMFailed 例外は、TobjS_c.h (TobjS.idl から派生) ではなく、tobj_c.h (tobj.idl から派生) で定義されます。これは、ネイティブ・クライアントでも XA リソース・マネージャをオープンできるからです。したがって、返される例外は、ネイティブ・クライアント・コードおよび Server::release() (ネイティブ・クライアントと共有される代替メカニズムである TransactionCurrent::close_xa_rm を使用している場合) で想定される例外と一致します。

 

Back to Top Previous Next
Contact e-docsContact BEAwebmasterprivacy