ここでは，EJBクライアントアプリケーションのクラスパスへのJARファイルの設定方法について説明します。EJBクライアントアプリケーションの開始に使用するコマンドによって，クラスパスへのJARファイルの設定方法が異なります。

• cjclstartapコマンドの場合
  cjclstartapコマンドを使用する場合は，EJBクライアントアプリケーションのオプション定義ファイル（usrconf.cfg）で，クラスパスにJARファイルを設定します。
  usrconf.cfg（Javaアプリケーション用オプション定義ファイル）については，マニュアル「アプリケーションサーバ リファレンス 定義編(サーバ定義)」の「14.2　usrconf.cfg（Javaアプリケーション用オプション定義ファイル）」を参照してください。
  
• vbjコマンドの場合
  vbjコマンドを使用する場合は，バッチファイル/シェルスクリプトファイル，またはコマンドの引数で設定します。
  

EJBクライアントアプリケーションの実行に必要なJARファイルを次の表に示します。

表3-12　EJBクライアントアプリケーションの実行に必要なJARファイル

JARファイル名	［種別］※1JARファイルの配置場所	含まれる内容	コマンド
			cjclstartap	vbj
hitj2ee.jar	［固定］ Windowsの場合 <Application Serverのインストールディレクトリ>\CC\lib UNIXの場合 /opt/Cosminexus/CC/lib	製品提供クラス	−	○
HiEJBClientStatic.jar	［固定］ Windowsの場合 <Application Serverのインストールディレクトリ>\CC\client\lib UNIXの場合 /opt/Cosminexus/CC/client/lib	製品提供クラス	−	○
vbjorb.jar vbsec.jar	［固定］ Windowsの場合 <Application Serverのインストールディレクトリ>\TPB\lib UNIXの場合 /opt/Cosminexus/TPB/lib	製品提供クラス	−	○
cprf.jar	［固定］ Windowsの場合 <Application Serverのインストールディレクトリ>\PRF\lib UNIXの場合 /opt/Cosminexus/PRF/lib	製品提供クラス	−	○
hntrlibMj.jar または hntrlibMj64.jar ※2 ※3	［固定］ Windowsの場合 <Program Files>\Hitachi\HNTRLib2\classes UNIXの場合 /opt/hitachi/HNTRLib2/classes	製品提供クラス	−	○
tpotsinproc.jar	［トランザクション使用］ Windowsの場合 <Application Serverのインストールディレクトリ>\TPB\lib UNIXの場合 /opt/Cosminexus/TPB/lib	製品提供クラス	−	△
ejbserver.jar	［トランザクション使用］ Windowsの場合 <Application Serverのインストールディレクトリ>\CC\lib UNIXの場合 /opt/Cosminexus/CC/lib		△	△
stubs.jar	［RMI-IIOPのスタブ］ J2EEサーバからダウンロード，またはダイナミッククラスローディング	RMI-IIOPのスタブ EJBオブジェクトのスタブ EJBホームオブジェクトのスタブ スタブが参照するクラス	△	△
<数字>.jar	［RMI-IIOPのインタフェース］ J2EEサーバからダウンロード	RMI-IIOPのインタフェース リモートインタフェース ホームインタフェース インタフェースが参照するクラス	○	○
ユーザ作成のJARファイル	ユーザ作成のクラス	EJBクライアントアプリケーションで利用するユーザ作成のクラスです。 ユーザが作成した独自のFilterクラス，Formatterクラス，またはHandlerクラスをEJBクライアントアプリケーションのユーザログ機能で使用する場合には，そのクラスもクラスパスに指定してください。※3	○	○

（凡例）

○：クラスパスに指定する必要がある。

△：必要に応じてクラスパスに指定する。

−：クラスパスに指定する必要がない。

注※1

種別には，次に示すものがあります。

• ［固定］
  EJBクライアントアプリケーションから呼び出すアプリケーションの数，内容に関係なく，指定するJARファイルのファイル名と配置場所は固定です。
  
• ［トランザクション使用］
  EJBクライアントアプリケーションでトランザクションを使用する場合に，該当するJARファイルを指定します。詳細については，マニュアル「アプリケーションサーバ 機能解説 基本・開発編(コンテナ共通機能)」の「3.20　EJBクライアントアプリケーションでトランザクションを開始する場合の注意事項」を参照してください。
  
• ［RMI-IIOPのスタブ］
  EJBクライアントアプリケーションから呼び出すアプリケーション単位に該当するJARファイルを指定します。ダイナミッククラスローディングを利用する場合は，指定する必要はありません。
  
• ［RMI-IIOPのインタフェース］
  RMI-IIOPのインタフェースをEJBクライアントアプリケーション側に取得していない場合，アプリケーション単位に該当するJARファイルをダウンロードして指定します。すでにRMI-IIOPのインタフェースをEJBクライアントアプリケーション側に取得している場合は，取得済みのクラスまたはJARファイルを指定します。
  

注※2

使用しているOSに合わせて，JARファイルを使用してください。HP-UX（IPF）の場合およびLinux（IPF）の場合は，hntrlibMj64.jarを指定してください。それ以外の場合は，hntrlibMj.jarを指定してください。なお，これらのJARファイルを指定することで，システムログの出力モードがサブディレクトリ共有モードになります。サブディレクトリ共有モードについては，「3.8.2　システムログの出力先のサブディレクトリ」を参照してください。

注※3

EJBクライアントアプリケーションのユーザログ出力機能を使用する場合に指定してください。EJBクライアントアプリケーションのユーザログ出力の設定については，マニュアル「アプリケーションサーバ 機能解説 拡張編」の「9.8　J2EEアプリケーションのユーザログ出力の設定」を参照してください。

注意

• Clientを使用してEJBクライアント環境を構築する場合は，格納ディレクトリの「<Application Serverのインストールディレクトリ>\CC」を，「<Application Serverのインストールディレクトリ>\CCL」と読み替えてください。
• Clientを使用してEJBクライアント環境を構築する場合は，EJBクライアントアプリケーションのトランザクションは使用できません。
• クラスパスでJARファイルを設定する場合，JARファイルの設定順序に注意してください。
  トランザクションを使用する場合，クラスパスには，tpotsinproc.jarとejbserver.jarを設定します。このとき，ejbserver.jarよりも先に，HiEJBClientStatic.jarを設定してください。
  性能解析トレース機能を利用する場合，クラスパスには，cprf.jarを設定します。このとき，HiEJBClientStatic.jarよりも先にcprf.jarを設定してください。
  逆の順序で設定した場合は，性能解析トレースの初期化に失敗します。また，逆の順序で設定した場合に，EJBクライアントアプリケーションのログレベルをWarning以上に設定しているときは，KDJE51008-Wのメッセージが理由コード「-4」で出力されます。なお，性能解析トレースの初期化に失敗した場合は，性能解析トレースは出力されませんが，EJBクライアントアプリケーションの処理は継続できます。