Oracle RM スイッチ モジュール

Oracle RM スイッチ モジュールのビルドに必要な情報を提供します。

Oracle 11 データベースおよび Oracle 18 データベースの両方のための Oracle RM スイッチ モジュールがサポートされています。

Windows 環境

ソース コード
Oracle RM スイッチ モジュールの COBOL ソース ファイルである ESORAXA.CBL は、デフォルトでは、%ProgramFiles(x86)%\Micro Focus\Enterprise Developer\src\enterpriseserver\xa ディレクトリにあります。
注: If you prefer to supply user credentials programatically rather than in the xa_open string, instructions for doing so are provided in the COBOL source file in the Customization section.
スイッチ モジュールのビルド
方法 1
  1. 管理者として、アプリケーションに応じて 32 ビットまたは 64 ビットの Enterprise Developer command promptを起動します。
  2. %ProgramFiles(x86)%\Micro Focus\Enterprise Developer\src\enterpriseserver\xa ディレクトリ (デフォルトの場所) に移動します。
  3. 次のように入力します。 build switch-module

    ここでの switch-module は、Oracle 11 データベースの場合は ora11、Oracle 18 データベースの場合は ora18 となります。

方法 2
  1. アプリケーションに応じて 32 ビットまたは 64 ビットの Enterprise Developer command promptを起動します。
  2. %ProgramFiles(x86)%\Micro Focus\Enterprise Developer\src\enterpriseserver\xa ディレクトリ (デフォルトの場所) にあるすべてのファイルを、WRITE 権限がある任意の場所にコピーします。
  3. コピーしたファイルが含まれているディレクトリに移動します。
  4. 次のように入力します。 build switch-module

    ここでの switch-module は、Oracle 11 データベースの場合は ora11、Oracle 18 データベースの場合は ora18 となります。

ビルド出力
ビルド プロセスによって、ESORAXA.CBL COBOL ソース ファイルから、バイナリ形式の次の 2 つの RM スイッチ モジュール ファイルが生成されます。
バイナリ ファイル タイプ
ESORAXA.DLL 静的
ESORAXA_D.DLL 動的

You can register an RM switch module with Enterprise Server dynamically, or register it statically depending on which binary file you use. We recommend that you use the dynamic switch module option, as this ensures that only active databases used in the global transaction participate in the TM/RM XA flow.

UNIX 環境

ソース コード
Oracle RM スイッチ モジュールの COBOL ソース ファイルである ESORAXA.CBL は、デフォルトでは、$COBDIR/src/enterpriseserver/xa ディレクトリにあります。
注: If you prefer to supply user credentials programatically rather than in the xa_open string, instructions for doing so are provided in the COBOL source file in the Customization section.
ビルド要件

ビルド スクリプトでは、現在の有効な作業モードを使用して、スイッチ モジュールのビルド方法が決定されます。ビルド スクリプトを呼び出す前に、データベース環境が正しく設定されていることを確認してください。詳細については、データベース ベンダーのドキュメントを参照してください。

スイッチ モジュールのビルド
$COBDIR/src/enterpriseserver/xa ディレクトリには、スイッチ モジュールのビルドに使用できる build バッチ ファイルが含まれています。
  1. $COBDIR/src/enterpriseserver/xa ディレクトリ (デフォルトの場所) にあるすべてのファイルを、WRITE 権限がある任意の場所にコピーします。
  2. コピーしたファイルが含まれているディレクトリに移動します。
  3. build ora」と入力します。
ビルド出力
ビルド プロセスによって、ESORAXA.CBL COBOL ソース ファイルから、バイナリ形式の次の 4 つの RM スイッチ モジュール ファイルが生成されます。
ESORAXA.so 32 ビット 静的
ESORAXA64.so 64 ビット 静的
ESORAXA_D.so 32 ビット 動的
ESORAXA64_D.so 64 ビット 動的

You can register an RM switch module with Enterprise Server dynamically, or register it statically depending on which binary file you use. We recommend that you use the dynamic switch module option, as this ensures that only active databases used in the global transaction participate in the TM/RM XA flow.

すべての環境

追加リソース
Oracle RM スイッチ モジュールの詳しい使い方 (オープン文字列定義や、サポートされる SQL 操作の詳細など) については、次のトピックを参照してください。
  • 追加ソフトウェア要件 (Windows)」トピックの「データベース アクセス - COBSQL (Pro*COBOL)」セクション(Windows)
  • 追加ソフトウェア要件 for Micro Focus Enterprise Developer UNIX Components(UNIX)」トピックの「データベース アクセス - COBSQL (Pro*COBOL)」セクション
  • Oracle RDBMS ドキュメントに用意されている「Developing Applications with Oracle XA」ヘルプ トピック