Oracle Tuxedo ATMIのWindows Server 2003での使用

以下の項では、UNIXサーバー・システム上のOracle Tuxedo ATMIとWindows Server 2003システム上のOracle Tuxedo ATMIの基本的な使い方の違いを説明します。

Windowsの留意事項

Oracle Tuxedo ATMIをWindowsシステムで使用する場合、以下の点に注意してください。

パス名を指定する場合は、ファイル名やディレクトリ名の区切り文字として、スラッシュ(/)ではなく円記号(¥)を使用します。完全修飾されたパス名には、ドライブ文字(C:など)を使用します。
実行可能ファイルに拡張子.exeを指定する必要はありません。この拡張子は、常にOracle Tuxedo ATMI for Windows用であるとみなされます。
ファイル名は、Windowsの命名規則に従って付けられます。たとえば、拡張子.dllが付いたファイルは、ダイナミック・リンク・ライブラリを示します。また、.libは、スタティック・リンク・ライブラリまたはインポートされたライブラリを示し、.cmdは、コマンド・スクリプトを示します。
Oracle Tuxedoシステムの実行可能ファイル、コマンド・スクリプト、およびダイナミック・リンク・ライブラリは、すべて%TUXDIR%¥binに格納されています。スタティック・リンク・ライブラリは、%TUXDIR%\libに格納されています。

構成に関する注意事項

Oracle Tuxedo ATMIソフトウェアをWindows Server 2003システムにセットアップする場合は、以下の点に注意してください。

サーバー名の大文字と小文字は区別されます。
Oracle Tuxedo ATMIアプリケーション・ファイルで指定するWindows Server 2003のマシン名は、常に大文字で指定する必要があります。
Oracle Tuxedoの構成ファイル(UBBCONFIG)内のOPENINFO文字列は、次の形式で指定する必要があります。

OPENINFO="resource managers:resource(s)"

例:

OPENINFO="TUXEDO\SQL:APPDIR1\bankdl3;bankdb;readwrite"

注意:

上記の例では、最初の区切り文字としてコロンを使用し、以降の区切り文字としてセミコロン(;)を使用しています。

マシンのタイプとユーザーID番号を指定する

構成ファイルのMACHINESセクションで、次の3つのエントリを指定します。

TYPE="WinNT"
UID=0
GID=0

UNIXシステムとWindows 2003システムが混在する環境の場合は、構成内のすべてのWindows Server 2003ノードに対して、MACHINESセクションで上記の3つのエントリを指定してください。

ネットワーク・ドライブを使用する

信頼性を確保するため、ネットワーク・ドライブは使用しないことをお薦めします。ただし、TUXCONFIGファイルをネットワーク・ドライブに持つWindows Server 2003マシン上でOracle Tuxedo ATMIアプリケーションを起動する場合は、パーミッションに関する次の規則に従う必要があります。

管理者(Administrator)としてネットワーク・ドライブに接続します。
管理者は、ローカル・システムとリモート・システムで同じパスワードを使用します。
tuxipcサービスのスタートアップ・オプションで、ENTRYオプションのLog On As This Accountを管理者(Administrator)に設定します。tuxipcサービスに管理者としての完全なアクセス権が付与されるように、パスワードは管理者用のパスワードと同じにする必要があります。

メモリー・バッファの割り当ておよび解放

Windows Server 2003システムでメモリー・バッファの割り当てや解放を行う場合は、必ずメモリー・バッファを割り当てたヒープを解放してください。これ以外のヒープを解放しようとすると、セグメント・エラーが発生します。

たとえば、Falloc()を使用して割り当てたメモリー・バッファを解放するには、Ffree()を使用します。malloc()を使用して割り当てたメモリー・バッファをFfree()で解放しようとすると、セグメント・エラーが発生します。この場合は、free()を使用して解放します。

Falloc、 Falloc32(3fml)およびFfree、 Ffree32(3fml)の詳細は、『Oracle Tuxedo ATMI FML関数リファレンス』を参照してください。malloc()およびfree()の詳細は、オペレーティング・システムに付属のドキュメントを参照してください。

bankappドライバを使用する

bankappプログラムは、Oracle Tuxedo ATMI for Windows 2003に同梱される小規模なサンプル・アプリケーションです。このサンプル・アプリケーションでは、Oracle Tuxedo ATMIの操作を試したり、Oracle Tuxedo ATMIのアプリケーション・コードの例を参照することができるほか、bankappドライバを使用して生成した%APPDIR%\UBBファイルを、新しいアプリケーションのテンプレートとして適用できます。driver.exeは、%TUXDIR%\APPS\bankapp\2003\driverに格納されています。

Oracle Tuxedo ATMIのアプリケーションを自動的に起動する

Oracle Tuxedo ATMIがWindows Server 2003システムにインストールされている場合は、MicrosoftのResource Kit for Windows 2003に格納されているsrvany.exeユーティリティ・プログラムを使用して、システムの起動時にOracle Tuxedo ATMIアプリケーションが自動的に起動されるようマシンを構成しておくと便利です。この手順の詳細は、srvany.wriとrktools.hlpを参照してください。

Oracle Tuxedo ATMIプログラムの起動時にプログラムを正しく自動起動させるには、Oracle Tuxedoシステムの環境変数である%TUXDIR%および%NLSPATH%を設定する必要があります。これらの環境変数は、通常のWindows 2003の方法、またはOracle管理プログラムを使用して設定します(「環境変数を設定および修正する」を参照)。

WindowsでのOracle Tuxedo ATMIの使用