J2EEアプリケーションを開発する際に，CJLogRecordクラスを使用して，次のようなログ出力処理を設定してください。

• 例外の内容と対応したメッセージIDを出力するための設定
• 出力したJ2EEアプリケーションごとにアプリケーション名を出力するための設定

CJLogRecordクラスを使用したログ出力処理のコーディング方法およびAPI詳細については，マニュアル「Cosminexus　リファレンス　API編」を参照してください。

簡易構築定義ファイルを編集して，ハンドラからのログの出力先，ログレベル，ログ面数，使用するフィルタ，フォーマッタなどを指定してください。

(a)　設定内容

簡易構築定義ファイルで論理J2EEサーバ（j2ee-server）の<configuration>タグ内に，ejbserver.applicationから始まるパラメタで，J2EEアプリケーションのユーザログを出力するための設定をします。ejbserver.applicationから始まるパラメタを次に示します。なお，<ハンドラ名称>には，キーの値を区別するためのハンドラ名称を指定してください。また，<ロガー名称>には，Loggerのインスタンスを取得するときに指定するロガー名称を指定してください。

• ejbserver.application.userlog.CJLogHandler.<ハンドラ名称>.appname
  ハンドラごとに，ログファイルに出力するメッセージのJ2EEアプリケーション名（AppNameフィールドの値）のデフォルト値を指定します。
  
• ejbserver.application.userlog.CJLogHandler.<ハンドラ名称>.count
  ハンドラごとに，ログファイルの面数を指定します。
  
• ejbserver.application.userlog.CJLogHandler.<ハンドラ名称>.encoding
  ハンドラごとに，ログファイルに出力する文字列のエンコーディングを指定します。
  
• ejbserver.application.userlog.CJLogHandler.<ハンドラ名称>.filter
  ハンドラごとに，使用するフィルタ名を指定します。
  
• ejbserver.application.userlog.CJLogHandler.<ハンドラ名称>.formatter
  ハンドラごとに，使用するフォーマッタ名を指定します。
  
• ejbserver.application.userlog.CJLogHandler.<ハンドラ名称>.level
  ハンドラごとに，ログ取得レベルの上限を指定します。
  
• ejbserver.application.userlog.CJLogHandler.<ハンドラ名称>.limit
  ハンドラごとに，ログファイルのサイズを指定します。
  
• ejbserver.application.userlog.CJLogHandler.<ハンドラ名称>.msgid
  ハンドラごとに，ログファイルに出力するメッセージのメッセージID（MsgIDフィールドの値）のデフォルト値を指定します。
  
• ejbserver.application.userlog.CJLogHandler.<ハンドラ名称>.path
  ハンドラごとに，ログファイルの出力先とプリフィックスを指定します。出力されるログファイル名は，「<プリフィックス><1〜16の番号>.log」になります。このキーは必ず指定してください。
  
• ejbserver.application.userlog.CJLogHandler.<ハンドラ名称>.separator
  ハンドラごとに，ログファイルに出力するメッセージを1文で出力するための，要素区切り文字のデフォルト値を指定します。
  
• ejbserver.application.userlog.loggers
  使用するロガー名称を宣言します。このキーは必ず指定してください。
  
• ejbserver.application.userlog.Logger.<ロガー名称>.handlers
  ロガーごとに，使用するハンドラ名称を指定します。このキーは必ず指定してください。
  
• ejbserver.application.userlog.Logger.<ロガー名称>.level
  ロガーごとに，ロガーのログ取得レベルを指定します。
  
• ejbserver.application.userlog.Logger.<ロガー名称>.useParentHandlers
  ロガーごとに，ロガーを通過するレベルのログレコードを，親のロガーが使用しているハンドラに伝播させるかどうかを指定します。
  
• ejbserver.application.userlog.Logger.<ロガー名称>.filter
  ロガーごとに，ロガーでメッセージの取捨選択に使用するフィルタを指定します。
  

J2EEアプリケーションのユーザログを出力するためには，少なくとも，次の三つのパラメタを指定する必要があります。

• ejbserver.application.userlog.CJLogHandler.<ハンドラ名称>.path
• ejbserver.application.userlog.loggers
• ejbserver.application.userlog.Logger.<ロガー名称>.handlers

簡易構築定義ファイルの詳細については，マニュアル「Cosminexus　簡易構築・運用ガイド」を参照してください。

(b)　注意事項

• ロガーには複数のハンドラを接続できます。ただし，複数のロガーに同一のPath設定を持つファイルハンドラ（CJMessageFileHandler）は接続できません。ファイルハンドラはロガーへの接続の指定（ejbserver.application.userlog.Logger.<ロガー名称>.handlersの値）を参照してインスタンス化します。この際，ログの出力先とプリフィックス（ejbserver.application.userlog.CJLogHandler.<ハンドラ名称>.pathの値）の同じハンドラがインスタンス化されている場合は，ログファイルのオープンに失敗します。
• ハンドラやロガーの設定および構築については，簡易構築定義ファイルで指定できますが，ハンドラの作成やロガーの構成変更をJ2EEアプリケーション内に直接実装する場合は，実行するアプリケーションにLoggingPermission("control")のセキュリティ権限が必要になります。LoggingPermission("control")のセキュリティ権限の設定方法については，「(3)　セキュリティポリシーの設定」を参照してください。

アプリケーションのソースプログラム上で，J2SE1.4仕様のLoggerクラスの構成を変更したり，FileHandlerクラスを作成したりする場合，セキュリティポリシーを設定する必要があります。セキュリティポリシーは，server.policyに設定します。

server.policyの設定内容を次に示します。

• FilterクラスやFormatterクラスなどをリフレクションで作成する場合は，次に示す行を追加します。
  

  permission java.lang.reflect.ReflectPermission "suppressAccessChecks";

  Handlerクラスは，ログマネジャからプロパティ値を取得し，実行時にリフレクション機能を使用してFormatterクラスやFilterクラスを生成します。そのため，リフレクションに関する権限が必要となります。
  
• ログマネジャのプロパティを設定する場合は，次に示す行を追加します。
  

  permission java.util.PropertyPermission "*", "read, write";

  ログマネジャがログ出力用のプロパティの値を読み込んだり，書き込んだりするための権限が必要となります。
  
• File出力を行うクラス（FileHandler，CJMessageFileHandler）を使用する場合は，次に示す行を追加します。
  

  permission java.io.FilePermission "<<ALL FILES>>", "read, write";

  ログをファイルへ出力するために読み込むための権限だけではなく，書き込み権限も必要となります。
  
• J2SE1.4仕様のロギングAPIを使用する場合は，次に示す行を追加します。
  

  permission java.util.logging.LoggingPermission "control";

  この値を指定しないと，ロギングAPIが使用できません。
  

J2EEアプリケーションでサーブレット上からJ2SE1.4仕様のロギングAPIを利用する場合の設定例を示します。

//
// Grant permissions to JSP/Servlet
// 
grant codeBase "file:${ejbserver.http.root}/web/${ejbserver.serverName}/-" {
   permission java.lang.RuntimePermission "loadLibrary.*";
   permission java.lang.RuntimePermission "queuePrintJob";
   permission java.net.SocketPermission "*", "connect";
   permission java.io.FilePermission "<<ALL FILES>>", "read, write";
   permission java.util.PropertyPermission "*", "read";
 
   //For J2SE Logging Source
   permission java.lang.reflect.ReflectPermission "suppressAccessChecks";
   permission java.util.PropertyPermission "*", "read, write";
   permission java.util.logging.LoggingPermission "control";
 
};