Oracle RM スイッチ モジュール

Oracle RM スイッチ モジュールのビルドに必要な情報を提供します。
制約事項: This topic applies only when the Enterprise Server feature is enabled.

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

Windows 環境

ソース コード
Oracle RM スイッチ モジュールの COBOL ソース ファイルである ESORAXA.CBL は、デフォルトでは、%ProgramFiles(x86)%\Micro Focus\Visual COBOL\src\enterpriseserver\xa ディレクトリにあります。
注: ユーザー資格情報を xa_open 文字列ではなくプログラムで指定する場合は、COBOL ソース ファイルの Customization section でその命令を指定します。
スイッチ モジュールをビルドする
方法 1
  1. 管理者として、アプリケーションに応じて 32 ビットまたは 64 ビットの Visual COBOL コマンド プロンプトを起動します。
  2. %ProgramFiles(x86)%\Micro Focus\Visual COBOL\src\enterpriseserver\xa ディレクトリ (デフォルトの場所) に移動します。
  3. 次のように入力します。build switch-module

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

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

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

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

RM スイッチ モジュールは、使用するバイナリ ファイルに応じて、Enterprise Server に動的に登録することも、静的に登録することもできます。動的なスイッチ モジュールを使用すると、グローバル トランザクションで使用されているアクティブなデータベースのみが TM/RM の XA フローに参加するようになるため、この方法を使用することをお奨めします。

UNIX 環境

ソース コード
Oracle RM スイッチ モジュールの COBOL ソース ファイルである ESORAXA.CBL は、デフォルトでは、$COBDIR/src/enterpriseserver/xa ディレクトリに配置されています。
注: ユーザー資格情報を xa_open 文字列ではなくプログラムで指定する場合は、COBOL ソース ファイルの Customization section でその命令を指定します。
ビルド要件

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

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

RM スイッチ モジュールは、使用するバイナリ ファイルに応じて、Enterprise Server に動的に登録することも、静的に登録することもできます。動的なスイッチ モジュールを使用すると、グローバル トランザクションで使用されているアクティブなデータベースのみが TM/RM の XA フローに参加するようになるため、この方法を使用することをお奨めします。

すべての環境

追加リソース
Oracle RM スイッチ モジュールの詳しい使い方 (オープン文字列定義や、サポートされる SQL 操作の詳細など) については、次のトピックを参照してください。
  • 「追加ソフトウェア要件 (Windows)」トピックの「データベース アクセス - COBSQL (Pro*COBOL)」の項(Windows)。
  • 「追加ソフトウェア要件(UNIX) for Micro Focus Visual COBOL Development Hub」トピックの「Database Access - COBSQL (Pro*COBOL)」の項。
  • Oracle RDBMS マニュアルの「Oracle XA でのアプリケーションの開発」ヘルプ トピック。
上位ヘルプ： RM スイッチ モジュールのビルド