7.7.12　ファイルイベント連携システムでの障害対策

(a)　snapshotlog.conf

${cosminexus.home}/CSC/custom-reception/fileevent/config/.+
${cosminexus.home}/CSC/custom-reception/fileevent/config/common/.+

(b)　snapshotlog2.conf

${cosminexus.home}/CC/server/public/ejb/.+/logs/csc/rcp/fileevent/.+/fileeventtrace_.*\.log
&{ejb.public.directory}/ejb/.+/logs/csc/rcp/fileevent/.+/fileeventtrace_.*\.log
&{ejb.server.log.directory}/csc/rcp/fileevent/.+/fileeventtrace_.*\.log

(c)　snapshotlog.param.conf

${cosminexus.home}/CSC/custom-reception/fileevent/config/.+
${cosminexus.home}/CSC/custom-reception/fileevent/config/common/.+

(a)　ファイルイベント受付にフォルト応答電文が返された場合

ファイルイベント受付にフォルト応答電文が返された場合のエラーの伝わり方については，マニュアル「サービスプラットフォーム 開発ガイド 受付・アダプタ定義編」の「付録A.7　カスタム受付でのエラーの伝わり方」の，サービス部品からユーザ定義例外のエラーがリターンした場合に関する説明を参照してください。

この場合は，出力されたメッセージに従って対処したあと，監視対象のファイルに応じて次のように対処してください。

(b)　カスタム受付フレームワークがエラーをリターンした場合

カスタム受付フレームワークがエラーをリターンした場合のエラーの伝わり方については，マニュアル「サービスプラットフォーム 開発ガイド 受付・アダプタ定義編」の「付録A.7　カスタム受付でのエラーの伝わり方」のHCSCサーバからエラーがリターンした場合に関する説明を参照してください。

この場合は，出力されたメッセージに従って対処したあと，次のように対処してください。

(c)　ファイルイベント受付がエラーを検知した場合

ファイルイベント受付が検知するエラーには次の種類があります。

• 取得対象ファイルが存在しない

• ロックファイルの作成失敗

• ロックファイルのロック取得失敗

• ロックファイルのロック解放失敗

• 監視対象のファイルのリネーム失敗（更新完了通知ファイルまたは取得対象ファイル）

エラーを検知した場合は，ファイルイベントトレースに取得ポイント「IN」のトレースが出力されているか確認してください。出力の有無に応じて，大まかな発生個所と対処を次に示す表から推測できます。

(a)　出力形式

性能解析トレースファイルに出力される形式は，J2EEサーバの性能解析トレースと同様です。詳細は，マニュアル「アプリケーションサーバ 機能解説 保守／移行編」の「7.3　Management Serverを利用した性能解析トレースファイルの収集」を参照してください。

(b)　出力される内容

性能解析トレースファイルに出力される内容を次の表に示します。

(c)　性能解析トレースの取得ポイント

ファイルイベント連携の性能解析トレースの取得ポイントには次に示す種類があります。

• ファイルイベント受付の処理時に取得

• ファイル監視処理の開始・終了時に取得

それぞれの取得ポイントを次に示します。

• ファイルイベント受付の処理時

  図7‒135　性能解析トレースの取得ポイント（ファイルイベント連携）

  イベントID，トレース取得ポイント，および性能解析トレース取得レベルを次の表に示します。表の「図中の番号」は，図中の番号と対応しています。

  表7‒163　性能解析トレース取得ポイント（ファイルイベント連携）

  イベントID	図中の番号	トレース取得ポイント	レベル※
  0x98B0	1	カスタム受付の入口	A
  0x98B1	2	カスタム受付の出口	A
  0x98B2	3	カスタム受付フレームワークの呼び出し口	B
  0x98B3	4	カスタム受付フレームワークの応答受信口	B
  0x9860	5	カスタム受付フレームワークの入口	A
  0x9861	6	カスタム受付フレームワークの出口	A
  0x9864	7	メッセージ配送制御の呼び出し口	A
  0x9865	8	メッセージ配送制御の応答受信口	A

  （凡例）

  A：「標準」であることを示します。

  B：「詳細」であることを示します。

  注※

  性能解析トレースレベルの変更方法の詳細については，マニュアル「アプリケーションサーバ 機能解説 保守／移行編」を参照してください。

• ファイル監視処理の開始・終了時

  図7‒136　性能解析トレースの取得ポイント（ファイルイベント連携）

  イベントID，トレース取得ポイント，および性能解析トレース取得レベルを次の表に示します。表の「図中の番号」は，図中の番号と対応しています。

  表7‒164　性能解析トレース取得ポイント（ファイルイベント連携）

  イベントID	図中の番号	トレース取得ポイント	レベル
  0x98B4	9	ファイル監視処理の開始	A
  0x98B5	10	ファイル監視処理の終了	A

  （凡例）

  A：「標準」であることを示します。

(a)　出力先

ファイルイベントトレースの出力先を次に示します。

<J2EEサーバのログ出力ディレクトリ>\csc\rcp\fileevent\<受付ID>

<J2EEサーバのログ出力ディレクトリ>は，HCSCサーバが動作するJ2EEサーバ用オプション定義ファイル（usrconf.cfg）のejb.server.log.directoryキーで指定します。ファイルイベントトレースのファイル名を次の表に示します。

(b)　ファイル面数

出力ファイルの面数のデフォルトは8面です。面数はファイルイベント受付コンフィグファイルのurecp-fileevent.trace.filenumキーで変更できます。

ファイルイベント受付コンフィグファイルについては，マニュアル「サービスプラットフォーム リファレンス」の「6.9.1　ファイルイベント受付コンフィグファイル」を参照してください。

(c)　ファイルサイズ

出力ファイルサイズのデフォルトは2MBです。ファイルサイズはファイルイベント受付コンフィグファイルのurecp-fileevent.trace.filesizeキーで変更できます。

ファイルイベント受付コンフィグファイルについては，マニュアル「サービスプラットフォーム リファレンス」の「6.9.1　ファイルイベント受付コンフィグファイル」を参照してください。

(d)　出力形式

ファイルイベントトレースの出力形式を次に示します。

(e)　出力される内容

ファイルイベントトレースに出力される内容を次の表に示します。

(f)　ファイルイベントトレースの取得ポイント

ファイルイベントトレースの取得ポイントを次に示します。

ファイルイベントトレースの取得ポイントと，および取得ポイント情報を次の表に示します。表の「図中の番号」は，上の図の番号と対応しています。