2.9.1 トレースファイル

トレースファイルに指定できるオプションとその指定方法を次の表に示します。

表2-8  トレースファイルに指定できるオプションとその指定方法

トレースファイルオプション指定方法
UAPトレースファイル出力先ディレクトリ次のどちらかで指定します。
  • SetUapTraceModeメソッドのTrcPathパラメタ
  • Client .NET構成定義の<uapTrace>要素のpath属性
トレースファイルのサイズ次のどちらかで指定します。
  • SetUapTraceModeメソッドのsizeパラメタ
  • Client .NET構成定義の<uapTrace>要素のfileSize属性
データトレースファイル出力先ディレクトリ次のどちらかで指定します。
  • SetDataTraceModeメソッドのTrcPathパラメタ
  • Client .NET構成定義の<dataTrace>要素のpath属性
トレースファイルのサイズ次のどちらかで指定します。
  • SetDataTraceModeメソッドのsizeパラメタ
  • Client .NET構成定義の<dataTrace>要素のfileSize属性
データトレースの最大データ長次のどちらかで指定します。
  • SetDataTraceModeメソッドのDataSizeパラメタ
  • Client .NET構成定義の<dataTrace>要素のmaxDataSize属性
エラートレースファイル出力先ディレクトリ次のどちらかで指定します。
  • SetErrorTraceModeメソッドのTrcPathパラメタ
  • Client .NET構成定義の<errTrace>要素のpath属性
トレースファイルのサイズ次のどちらかで指定します。
  • SetErrorTraceModeメソッドのsizeパラメタ
  • Client .NET構成定義の<errTrace>要素のfileSize属性
メソッドトレースファイル出力先ディレクトリ次のどちらかで指定します。
  • SetMethodTraceModeメソッドのTrcPathパラメタ
  • Client .NET構成定義の<methodTrace>要素のpath属性
トレースファイルのサイズ次のどちらかで指定します。
  • SetMethodTraceModeメソッドのsizeパラメタ
  • Client .NET構成定義の<methodTrace>要素のfileSize属性
デバッグトレースファイル出力先ディレクトリClient .NET構成定義の<debugTrace>要素のpath属性で指定します。
デバッグトレースの最大ファイル数Client .NET構成定義の<debugTrace>要素のfileCount属性で指定します。

トレース情報の出力ファイル名を次の表に示します。

表2-9 トレース情報の出力ファイル名

トレースファイル出力ファイル名
UAPトレースdcuap1.trc
dcuap2.trc
データトレースdcdat1.trc
dcdat2.trc
エラートレースdcerr1.trc
dcerr2.trc
メソッドトレースdcmtd1.trc
dcmtd2.trc
デバッグトレースdcCltxxxxxxxxxxxxx.dmp
(xxxxxxxxxxxxx:時刻から生成される数字)

指定したファイル出力先ディレクトリに出力ファイル名のファイルがない場合は,新規にトレースファイルを作成します。また,指定したディレクトリがない場合,および指定したディレクトリに書き込み権限がない場合は,トレースファイルを出力できません。

ファイルへの書き込みは追加モードで実行されます。二つのトレースファイルはラウンドロビン方式で使用されます(デバッグトレースのトレースファイルは除きます)。指定したトレースファイルのサイズを超えた書き込みが発生すると,ファイルの切り替えを行い,次のファイルの先頭から書き込みます。したがって,切り替えられる前のファイルは指定したサイズよりもファイルのサイズが大きくなる場合があります。

複数のCUP.NETのトレースファイルの出力先に同じディレクトリを指定すると,複数のCUP.NETのトレース情報が混在し,トラブルシュートが困難になる場合があります。そのため,トレースファイルの出力先ディレクトリは,それぞれのCUP.NETで別々にすることをお勧めします。