EJBクライアントアプリケーションのシステムログでは，メッセージログ，例外ログ，保守用ログの3種類のログが出力されます。EJBクライアントアプリケーションでは，必要に応じて，システムログの出力先や出力レベル，出力先のサブディレクトリの設定を変更できます。

(a)　システムログの設定方法

EJBクライアントアプリケーションの開始に使用するコマンドによって，EJBクライアントアプリケーションのシステムログの設定方法が異なります。

• cjclstartapコマンドの場合
  cjclstartapコマンドを使用する場合は，EJBクライアントアプリケーションのプロパティファイル（usrconf.properties）で，システムログのプロパティを設定します。
  
• vbjコマンドの場合
  vbjコマンドを使用する場合は，バッチファイル/シェルスクリプトファイル，またはコマンドの引数で，システムログのプロパティを設定します。
  

(b)　システムログの出力先や出力レベルの設定

出力先や出力レベルの設定の変更については，「19.5.2　システムログの出力先や出力レベルの変更」を参照してください。

(c)　システムログの出力先のサブディレクトリの設定

EJBクライアントアプリケーションのシステムログは，EJBクライアントアプリケーションのプロセス単位で出力されます。システムログでは，プロセスごとにログ出力先のサブディレクトリを作成するか，複数のプロセスでログ出力先のサブディレクトリを共有することができます。プロセスごとにログ出力先のサブディレクトリを作成する動作モードのことをサブディレクトリ専有モード，複数のプロセスでログ出力先のサブディレクトリを共有する動作モードのことをサブディレクトリ共有モードといいます。なお，既存のEJBクライアントアプリケーションをそのまま使用する場合は，サブディレクトリ専有モードで動作します。

サブディレクトリ共有モードとサブディレクトリ専有モードの違いを次の表に示します。

表19-6　サブディレクトリ共有モードとサブディレクトリ専有モードの違い

項目	サブディレクトリ共有モード	サブディレクトリ専有モード
複数のプロセスでのサブディレクトリ共有の可否	共有できます。	共有できません。
ログ管理ファイル作成	作成されます。	作成されません。
ejbserver.client.ejb.logキー※のデフォルト値	system	ejb
ejbserver.client.log.appidキー※のデフォルト値	ejbcl	EJBクライアントアプリケーション識別ID
ejbserver.client.log.directorynumキー※の指定	常に無効です。	ejbserver.client.log.appidキーを指定した場合は，無効です。
ejbserver.logger.channels.define.<チャネル名>.filenumキー※に指定できる面数	1〜64	1〜16
ejbserver.logger.channels.define.<チャネル名>.filesizeキー※に指定できる容量（バイト）	4,096〜16,777,216	4,096〜2,147,483,647

注※　EJBクライアントアプリケーションの開始時に指定するシステムプロパティです。

ポイント

サブディレクトリ専有モードは06-50よりも前のバージョンとの互換用に使用するモードであるため，EJBクライアントアプリケーションを新規作成する場合は，サブディレクトリ共有モードを使用することをお勧めします。

注意

• cjclstartapコマンドでEJBクライアントアプリケーションを実行する場合は，サブディレクトリ共有モードを使用してください。
• EJBクライアントアプリケーションのユーザログ機能を使用する場合は，サブディレクトリ共有モードを使用してください。

• 動作モードの指定
  サブディレクトリ共有モードとサブディレクトリ専有モードのどちらを使用するかは，クラスパスで指定できます。使用する動作モードによって，クラスパスに指定するJARファイルが異なります。クラスパスの指定については，「19.3　EJBクライアントアプリケーションのクラスパスへのJARファイルの設定」を参照してください。
  
• サブディレクトリの共有
  サブディレクトリ共有モードを使用している場合は，ログ出力先のサブディレクトリを共有できます。サブディレクトリの共有については，「19.5.3　複数プロセスでのログ出力先のサブディレクトリの共有」を参照してください。
  
• サブディレクトリ数の管理
  サブディレクトリ専有モードを使用している場合は，ログ出力先のサブディレクトリ数を管理できます。サブディレクトリ数の管理については，「19.5.4　ログ出力先のサブディレクトリ数の管理」を参照してください。
  

EJBクライアントアプリケーションが出力するログ（ユーザログ）を日立トレース共通ライブラリ形式で出力できます。日立トレース共通ライブラリ形式で出力することで，システムログとEJBクライアントアプリケーションのログを同じ形式で扱うことができるようになり，システム全体のログ運用の信頼性を高められます。

EJBクライアントアプリケーションの開始に使用するコマンドによって，EJBクライアントアプリケーションのユーザログの設定方法が異なります。

• cjclstartapコマンドの場合
  cjclstartapコマンドを使用する場合は，EJBクライアントアプリケーションのプロパティファイル（usrconf.properties）でユーザログの設定をします。ejbserver.applicationから始まるキーで，ユーザログの出力先ファイル，ログレベル，ログ面数，使用するフィルタおよびフォーマッタなどを指定してください。指定できるキーについては，マニュアル「Cosminexus　リファレンス　定義編」を参照してください。
  
• vbjコマンドの場合
  EJBクライアントアプリケーションのユーザログのファイルハンドラとして，CJMPMessageFileHandlerが提供されています。vbjコマンドを使用する場合は，CJMPMessageFileHandlerのログの出力先ファイル，ログレベル，ログ面数，使用するフィルタおよびフォーマッタなどは，EJBクライアントアプリケーションのユーザログ用の設定ファイルで設定します。設定方法については，マニュアル「Cosminexus　機能解説」のEJBクライアントアプリケーションでのユーザログ出力の実装に関する説明を参照してください。