ODBC RM スイッチ モジュールの汎用 1 フェーズ コミットのビルドに必要な情報について説明します。
- ソース コード
- ODBC RM スイッチ モジュールの汎用 1 フェーズ コミットの COBOL ソース ファイル ESXDBXA.CBL は、デフォルトでは、%ProgramFiles(x86)%\Micro Focus\Enterprise Developer\src\enterpriseserver\xa ディレクトリにあります。
注：ユーザー資格情報を xa_open 文字列ではなくプログラムで指定する場合は、COBOL ソース ファイルのCustomization sectionに手順が記載されています。
- ビルド要件
- ODBC RM スイッチ モジュールをビルドするには、使用している Windows のバージョン用の Windows ソフトウェア開発キット (SDK) がインストールされている必要があります。
このスイッチ モジュールをビルドする前に、Windows SDK LIB ディレクトリのサブディレクトリにある odbc32.lib ファイルのパスが LIB 環境変数に含まれていることを確認してください。
いくつかの OpenESQL 指令はプロセス ベースであり、通常はデータベース接続を行うプログラムのコード内で設定する必要があります。
サービスをコンテナー管理アプリケーションとしてディプロイされた Enterprise Server で実行する場合は、プログラム ソースのコンパイル時ではなく RM スイッチ モジュールのコンパイル時に、適切な指令を指定する必要があります。詳細については、「範囲 - OpenESQL SQL コンパイラ指令オプション」のトピックで、プロセス ベースの OpenESQL 指令の一覧を参照してください。
- スイッチ モジュールのビルド
-
- 方法 1
-
- 管理者として、アプリケーションに応じて 32 ビットまたは 64 ビットの Enterprise Developer コマンド プロンプトを起動します。
- %ProgramFiles(x86)%\Micro Focus\Enterprise Developer\src\enterpriseserver\xa ディレクトリ (デフォルトの場所) に移動します。
- 「build odbc」と入力します。
- 方法 2
-
- アプリケーションに応じて 32 ビットまたは 64 ビットの Enterprise Developer コマンド プロンプトを起動します。
- %ProgramFiles(x86)%\Micro Focus\Enterprise Developer\src\enterpriseserver\xa ディレクトリ (デフォルトの場所) にあるすべてのファイルを、WRITE 権限がある任意の場所にコピーします。
- コピーしたファイルが含まれているディレクトリに移動します。
- 「build odbc」と入力します。
- ビルド出力
- ビルド プロセスによって、ESODBCXA.CBL COBOL ソース ファイルから、バイナリ形式の次の 2 つの RM スイッチ モジュール ファイルが生成されます。
| ファイル |
タイプ |
| ESODBCXA.DLL |
静的 |
| ESODBCXA_D.DLL |
動的 |
RM スイッチ モジュールの登録は、Enterprise Server で動的に行うか、使用するバイナリ ファイルに応じて静的に行います。動的なスイッチ モジュールを使用すると、グローバル トランザクションで使用されているアクティブなデータベースのみが TM/RM の XA フローに参加するようになるため、Micro Focus ではこの方法を使用することをお勧めします。
- 制限事項
- ODBC モジュールでは 1 フェーズ コミットしかサポートされないため、次の SQL 操作は、ディプロイされたコンテナー管理サービスのソースではサポートされません。
- CONNECT
- DISCONNECT
- BEGIN TRANSACTION
- COMMIT
- ROLLBACK
- 追加リソース
- xa_open 文字列の定義を含む、ODBC RM スイッチ モジュールの使い方の詳細については、「ODBC xa_open 文字列の汎用 1 フェーズ コミット」を参照してください。