7.3.2　障害情報の取得方法（サービスプラットフォーム）

(a)　HCSC-Managerのログ

HCSC-Manager定義ファイルで次のパラメタを指定します。

• cscmng.log.message.filesize=メッセージログファイルサイズ

• cscmng.log.message.filenum=メッセージログファイル面数

HCSC-Manager定義ファイルの詳細については，マニュアル「サービスプラットフォーム リファレンス」の「6.5.3　HCSC-Manager定義ファイル」を参照してください。

(b)　統合メッセージログ

統合メッセージログは，manager.cfg（Managerログ設定ファイル）でファイルのサイズ，面数などを指定します。manager.cfgの詳細については，マニュアル「アプリケーションサーバ リファレンス 定義編(サーバ定義)」の「8.2.9　manager.cfg（Manager設定ファイル）」を参照してください。

(c)　J2EEサーバの稼働ログ

J2EEサーバの稼働ログは次のように指定します。

• ファイルの出力先

  HCSCサーバが動作するJ2EEサーバのusrconf.cfg（J2EEサーバ用オプション定義ファイル）のejb.server.log.directoryキーで指定します。デフォルトの出力先は次のとおりです。

  <サービスプラットフォームのインストールディレクトリ>\CC\server\public\ejb\<J2EEサーバ名>\logs

  usrconf.cfgの詳細については，マニュアル「アプリケーションサーバ リファレンス 定義編(サーバ定義)」の「2.2.2　usrconf.cfg（J2EEサーバ用オプション定義ファイル）」を参照してください。

• ファイルのサイズ，面数など

  HCSCサーバが動作するJ2EEサーバのusrconf.properties（J2EEサーバ用ユーザプロパティファイル）で指定します。

  usrconf.propertiesの詳細については，次に示すマニュアルを参照してください。

  • 推奨モードの場合

    マニュアル「アプリケーションサーバ リファレンス 定義編(サーバ定義)」の「2.2.3　usrconf.properties（J2EEサーバ用ユーザプロパティファイル）」

  • V9互換モードの場合

    マニュアル「アプリケーションサーバ 機能解説 互換編」の「10.1.1　usrconf.properties（J2EEサーバ用ユーザプロパティファイル）」

(a)　データ変換APIの実行時に出力されるデバッグ情報

データ変換APIの実行時に出力されるデバッグ情報を取得するには，usrconf.properties（J2EEサーバ用ユーザプロパティファイル）の次に示すシステムプロパティを設定してください。これらのシステムプロパティの設定方法については，「2.3.9(8)　データ変換APIの動作を指定する」を参照してください。

• csc.dt.debugtrace=デバッグ情報の出力有無（ONを指定します）

• csc.dt.debugtrace.filepath=デバッグ情報の出力先パス

• csc.dt.debugtrace.filenum=デバッグ情報ファイルの最大面数

• csc.dt.debugtrace.filesize=デバッグ情報ファイルの1面当たりの最大サイズ

これによって，csc.dt.debugtrace.filepathプロパティで設定したパスにデバッグ情報が出力されます。ファイルは次のように，データ変換APIのインスタンス（グループ）ごとに異なるファイル名で出力されます。シフトモードの場合はファイル名に<面数>は入りません。

cscdebug_<グループ名>_<面数>.log

それ以外のファイルのローテーション方式や切り替え時刻などの設定方法については，次に示すマニュアルを参照してください。

• 推奨モードの場合

  マニュアル「アプリケーションサーバ リファレンス 定義編(サーバ定義)」の「2.2.3　usrconf.properties（J2EEサーバ用ユーザプロパティファイル）」，

• V9互換モードの場合

  マニュアル「アプリケーションサーバ 機能解説 互換編」の「10.1.1　usrconf.properties（J2EEサーバ用ユーザプロパティファイル）」

(b)　HCSCサーバでのデータ変換時に出力されるデバッグ情報

HCSCサーバでのデータ変換時に出力されるデバッグ情報を取得するには，HCSCサーバランタイム定義ファイルの次のプロパティで，採取の有無を指定します。

• telegramtrace=ユーザ電文トレースの採取の有無（デバッグ情報の採取もONを指定します）

また，次のプロパティで，出力先パス，ファイルのサイズ，ファイル面数および出力契機を指定します。

• telegramtrace-filepath=ユーザ電文トレース出力先パス

• telegramtrace-filesize=ユーザ電文トレースファイルサイズ

• telegramtrace-filenum=ユーザ電文トレース面数

• telegramtrace-trigger=ユーザ電文トレースの出力契機（デバッグ情報の出力を示すDTERRを指定します）

telegramtrace-triggerプロパティには複数の値をコンマで区切って指定できるため，ユーザ電文トレースの出力契機と，デバッグ情報の出力契機を同時に指定できます。

デバッグ情報のファイル名を次に示します。シフトモードの場合はファイル名に<面数>は入りません。

csctelegram_<HCSCサーバ名>_<面数>.log

出力されたデバッグ情報の確認方法については，「7.4.6　デバッグ情報」を参照してください。また，トレースファイルのローテーション方式などの設定については，マニュアル「アプリケーションサーバ リファレンス 定義編(サーバ定義)」を参照してください。

(c)　データ変換単体テストコマンドの実行時に出力されるデバッグ情報

データ変換単体テストコマンド（csctransformコマンド，cscbinaryparseコマンド，およびcscgenbinaryコマンド）の実行時に出力されるデバッグ情報を取得するには，各コマンドの実行時（またはコマンドプロパティファイル）で指定します。詳細については次に示す記載個所を参照してください。

デバッグ情報のファイル名を次に示します。

cscdebug_dtcommand_<面数>.log

出力ファイルの最大面数は16，1面当たりの最大サイズは2147483647バイトです。面数の最大値，最大サイズ，ローテーション方式は変更できません。

(a)　例外ログ

例外ログは必ず出力されます。なお，出力されるファイルのサイズ，および面数は，変更できます。

例外ログの種類については，「7.4.7(1)　例外ログ」を参照してください。

(b)　メンテナンスログ

メンテナンスログは必ず出力されます。メンテナンスログは，出力されるファイルのサイズ，および面数を変更できます。

HCSC-Manager定義ファイルの次のパラメタを指定します。

• cscmng.log.maintenance.filesize=メンテナンスログファイルサイズ

• cscmng.log.maintenance.filenum=メンテナンスログファイル面数

HCSC-Manager定義ファイルの詳細については，マニュアル「サービスプラットフォーム リファレンス」の「6.5.3　HCSC-Manager定義ファイル」を参照してください。また，ログファイルのローテーション方式などの設定については，マニュアル「アプリケーションサーバ リファレンス 定義編(サーバ定義)」を参照してください。

(c)　インストールログ

必ず出力されます。

(d)　メソッドトレース

メソッドトレースは必ず出力されます。メソッドトレースは，出力される出力先やファイルのサイズ，面数，および出力レベルを決める必要があります。HCSCサーバランタイム定義ファイルの次のプロパティを指定します。

HCSCサーバランタイム定義ファイルの次のプロパティを指定します。

• methodtrace-filepath=メソッドトレース・例外ログの出力先パス

• methodtrace-filesize=メソッドトレースファイルサイズ

• methodtrace-filenum=メソッドトレースファイル面数

• methodtrace-level=メソッドトレースの出力レベル

HCSCサーバランタイム定義ファイルの詳細については，マニュアル「サービスプラットフォーム リファレンス」の「6.5.6　HCSCサーバランタイム定義ファイル」を参照してください。また，トレースファイルのローテーション方式などの設定については，マニュアル「アプリケーションサーバ リファレンス 定義編(サーバ定義)」を参照してください。

(e)　保守情報

障害を調査するために必要となる保守情報を次の表に示します。