EJBクライアントアプリケーションでトランザクションを使用するために，次のJARファイルをクラスパスに設定します。

Windowsの場合

• <Cosminexusのインストールディレクトリ>\TPB\lib\tpotsinproc.jar
• <Cosminexusのインストールディレクトリ>\CC\lib\ejbserver.jar^※

UNIXの場合

• /opt/Cosminexus/TPB/lib/tpotsinproc.jar
• /opt/Cosminexus/CC/lib/ejbserver.jar^※

注※

クラスパスの設定で，ejbserver.jarはHiEJBClientStatic.jarよりも後ろに設定してください。

クラスパスへのJARファイルの設定については，「19.3　EJBクライアントアプリケーションのクラスパスへのJARファイルの設定」を参照してください。

EJBクライアントアプリケーションでトランザクションを使用するために設定が必要なキーについて説明します。プロパティの設定については，「19.4　EJBクライアントアプリケーションのプロパティの設定」を参照してください。各キーの詳細については，マニュアル「Cosminexus　リファレンス　定義編」を参照してください。

EJBクライアントアプリケーションでトランザクションを使用するためには，次のキーを設定します。

(a)　必須のプロパティ

• ejbserver.client.transaction.enabled
  「true」を指定して，EJBクライアントアプリケーションでのトランザクションの使用を有効にします。
  
• ejbserver.distributedtx.recovery.port
  グローバルトランザクションを使用するとき，トランザクションリカバリで使用する固定ポート番号を指定します。EJBクライアントのプロセスごとに別のポート番号を指定してください。また，同一マシン上で動作するアプリケーションサーバのリカバリ用ポート番号とは別のポート番号を指定してください。
  
• ejbserver.client.transaction.clientName
  トランザクションサービスが使用するクライアント名を指定します。ここでは，EJBクライアントのプロセスごとに別の名前を指定してください。また，同一マシン上で動作するJ2EEサーバ名とは別の名前を指定してください。
  
• ejbserver.distributedtx.ots.status.directory1
  トランザクションサービスが使用するステータスファイルや，そのバックアップを配置するディレクトリを指定します。EJBクライアントのプロセスごとに別のディレクトリを指定してください。また，J2EEサーバに指定したステータスファイルのディレクトリとは別のディレクトリを指定してください。
  

(b)　任意のプロパティ

• ejbserver.jta.TransactionManager.defaultTimeOut
  トランザクションタイムアウトが発生するまでの時間を指定します。
  
• ejbserver.distributedtx.ots.status.directory2
  トランザクションサービスが使用するステータスファイルや，そのバックアップを配置する二つ目のディレクトリを指定します。EJBクライアントのプロセスごとに別のディレクトリを指定してください。また，J2EEサーバに指定したステータスファイルのディレクトリとは別のディレクトリを指定してください。
  

EJBクライアントアプリケーションのトランザクションの設定での注意事項を次に示します。

グローバルトランザクションを使用するためには，アプリケーションサーバ側でライトトランザクション機能を無効にする必要があります。デフォルトの設定では，ライトトランザクション機能が有効になっています。J2EEサーバのusrconf.propertiesのejbserver.distributedtx.XATransaction.enabledキーで「true」を指定すると，ライトトランザクション機能が無効となり，グローバルトランザクションが利用できるようになります。