TRNイベントトレース定義

set形式

〔set prf_file_size=TRNイベントトレース情報ファイルのサイズ〕
〔set prf_information_level=1|0〕
〔set prf_file_count=TRNイベントトレース情報ファイルの世代数〕

コマンド形式

なし。

●prf_file_size=TRNイベントトレース情報ファイルのサイズ

　〜〈符号なし整数〉((1024〜1048576))《10240》（単位：キロバイト）

TRNイベントトレース情報ファイルのサイズを指定します。

トレース情報は，通常ファイルに出力します。このファイルはTRNイベントトレース定義のprf_file_countオペランドの指定値分の世代を用意し，すべての世代を使用したらオーバラップして上書きします。このため，ある程度時間が経つと古いトレース情報がなくなります。prf_file_sizeオペランドの指定値を大きくすることで，ファイルを上書きする時間を延長できます。

トランザクション実行中に取得するトレースファイルの1ファイルサイズの算出式を，次に示します（単位：バイト）。

1ファイルサイズ※=128＋（12×アクセスするリソースマネジャ数×320×実行トランザクション数）

注※

2相コミットのトランザクションの場合，1トランザクションブランチ当たりに取得するトレース量は「12×アクセスするリソースマネジャ数」となります。ただし，トレース量は，ユーザサーバにリンケージされているXAインタフェースオブジェクトファイルや，トランザクションの最適化などの条件によって異なります。

●prf_information_level=1|0

TRNイベントトレース関連のメッセージの表示レベルを指定します。

0

表示レベル0のTRNイベントトレース関連のメッセージ（警告および障害メッセージ）をsyslogに出力します。

1

表示レベル1以下のTRNイベントトレース関連のメッセージをsyslogに出力します。

TRNイベントトレース関連のメッセージIDと表示レベルの関係を次に示します。ここで指定を省略した場合，性能検証用トレース定義の値を仮定します。

メッセージID	表示レベル
KFCA26700-W	0
KFCA26705-W	0
KFCA26710-I	1

表示レベル0のメッセージの出力を抑止する場合，システム共通定義，または性能検証用トレース定義で環境変数DCSYSLOGOUTに0を指定してください。システム共通定義および性能検証用トレース定義の両方に，環境変数DCSYSLOGOUTが指定されている場合，システム共通定義の指定が優先されます。

環境変数DCSYSLOGOUTの詳細については，「ログサービス定義」の環境変数DCSYSLOGOUTの説明を参照してください。

●prf_file_count=TRNイベントトレース情報ファイルの世代数

　〜〈符号なし整数〉((3〜256))《3》

TRNイベントトレース情報ファイルの世代数を指定します。