6.3.2　回線トレースファイルの運用

(a)　見積もりに必要な情報

トラブルシュート関連定義のtrb_trace_typeオペランドに1を指定した場合に，回線トレースファイルのサイズおよびファイル数を見積もるために必要になる情報を次に示します。

• トランザクション単位のバイト数：480

• SDBハンドラ機能の個別開始APIの実行回数単位のバイト数：100

• SDBハンドラ機能のDBアクセスAPIの実行回数単位のバイト数：108

• SDBハンドラ機能の個別終了APIの実行回数単位のバイト数：52

• SDBハンドラ機能の一括削除APIの実行回数単位のバイト数：52

• SDBハンドラ機能のシステム構成表示のバイト数：52

• メッセージ受信単位のバイト数：380

• メッセージ送信単位のバイト数：380

• 1ブロック単位に付加する情報のバイト数：96

• 1ファイル単位に付加する情報のバイト数：128＋34×（サービス数＋DBキュー機能で使用するDBキュー数＋オンラインバッチ機能で使用するDBキュー数＋オンラインバッチ機能で使用するロット数）＋256

SDBハンドラ機能については，TP1/FSPの関連ドキュメントを参照してください。

回線トレースファイルに出力する情報の合計は次に示す式で求める値になります。

回線トレースファイルに出力する情報の合計（T）
  ＝（480×x）＋（380×y）＋（380×z）＋h＋u
    ＋（↑（（（480×x）＋（380×y）＋（380×z）＋h＋u）÷b）↑×96）
    ＋（128＋34×（s＋d1＋d2＋l）＋256）

（凡例）

↑↑：小数点以下を切り上げます。

x：トランザクション数

y：受信メッセージ数

z：送信メッセージ数

h：SDBハンドラ機能を使用する場合に加算する値（TP1/FSPのSDBハンドラ機能の各種API実行回数×ｘ×該当するAPIの実行回数単位のバイト数）。使用しない場合は0を指定する。

u：ee_trb_utrace_put関数×（ee_trb_utrace_put関数で取得するトレースデータのデータ長＋28）バイト

b：バッファサイズ。trb_extend_functionオペランドに00000001を論理和で指定した場合，trb_line_trace_buffer_sizeオペランドの指定値とtrb_line_cmtrace_buffer_sizeオペランドの指定値の小さい方を指定する。trb_extend_functionオペランドを省略または00000000を論理和で指定した場合は，trb_line_trace_buffer_sizeオペランドの指定値を指定する。

s：サービス数

d1：DBキュー機能で使用するDBキュー数

d2：オンラインバッチ機能で使用するDBキュー数

l：オンラインバッチ機能で使用するロット数

回線トレースファイルに出力する情報の合計（T）から，回線トレースファイルのサイズおよびファイル数を見積もってください。6時間（21600秒）で指定したファイル数を使い切り，ラウンドロビン方式で最初に作成したファイルの上書きが開始されるように，回線トレースファイルのサイズおよびファイル数を指定することをお勧めします。

(b)　見積もり例

回線トレースファイルの見積もり例を次に示します。

前提条件

• 1サービス内で実行するコミットまたはロールバックの数は1回

  UAPで発行する数は0回で，TP1/EEで発行する数が1回です。

• 1メッセージの受信で起動されるトランザクションは1

• 1トランザクションのメッセージ送信回数は1

• 1秒間当たりに稼働するサービス数は100

  トランザクション数＝100×1となります。

• サービス数は5000

• trb_line_trace_buffer_sizeオペランドの指定値は200キロバイト（204800バイト）

• 1トランザクションで21回の個別開始APIと33回のDBアクセスAPIを発行（SDBハンドラ機能を使用する場合）

SDBハンドラ機能を使用しない場合

T＝（（480×100×21600）＋（380×100×21600）
   ＋（380×100×21600））
   ＋（↑（（（480×100×21600）
   ＋（380×100×21600）
   ＋（380×100×21600））÷204800）↑×96）
   ＋（128＋34×5000＋256）
 ＝2679825968

（凡例）

↑↑：小数点以下を切り上げます。

回線トレースファイルに出力する情報の合計は，2679825968バイト（約2.5ギガバイト）になります。

ファイル数を3ファイルに固定すると，1ファイルに格納する情報は，次のようになります。

1ファイルに格納する情報＝2679825968÷3＝893275323

1ファイルに格納する情報は，893275323バイト（約0.8ギガバイト）です。したがって，ファイルサイズを1ギガバイトとします。

SDBハンドラ機能を使用する場合

T＝（（480×100×21600）＋（380×100×21600）
   ＋（380×100×21600））＋12234240000※
   ＋（↑（（（480×100×21600）
   ＋（380×100×21600）＋（380×100×21600）
   ＋12234240000※）÷204800）↑×96）
   ＋（128＋34×5000＋256）
 ＝14919800720

（凡例）

↑↑：小数点以下を切り上げます。

注※

SDBハンドラ機能を使用する場合の「h」の値は，次の計算式で求められます。

（21×100×100×21600）＋（33×108×100×21600）＝12234240000

回線トレースファイルに出力する情報の合計は，14919800720バイト（約13.9ギガバイト）になります。

ファイル数を3ファイルに固定すると，1ファイルに格納する情報は，次のようになります。

1ファイルに格納する情報＝14919800720÷3＝4973266907

1ファイルに格納する情報は，4973266907バイト（約4.64ギガバイト）になりますが，回線トレースファイルの最大サイズは4000000キロバイト（約3.8ギガバイト）のため，ファイルサイズを固定して計算し直します。

ファイルサイズを2ギガバイトに固定すると，ファイル数は次のようになります。

ファイル数＝14919800720÷（2×1024×1024×1024）≒7

したがって，ファイル数を7ファイルとします。

(a)　取得内容

メッセージ送受信が正常終了した場合の取得内容を，オペランドの指定値によって変更できます。オペランドの指定値別に，回線トレース情報の取得内容について説明します。

00000000（デフォルト）

すべての回線トレース情報を，送信側と受信側で取得します。

送受信処理が正常に完了した場合は，最大で376バイト取得します。

00000020

送受信データの先頭にある製品ヘッダ（RPCの場合は264バイト，リモートAPI機能の場合は376バイト）を回線トレース情報として取得します。RPCのフラグメントメッセージの場合は，フラグメントごとに製品ヘッダ分だけ取得します。該当するフラグメントで，製品ヘッダ分の回線トレースを取得済みの場合，送受信データの内容は取得しません。

また，送受信データに製品ヘッダがない場合は，送受信データ長を0として回線トレースを取得します。

(b)　取得サイズの差異

回線トレース情報の取得サイズの差異について，次の図に示します。この例では，RPCのメッセージを4回に分けて受信したため，メッセージが四つに分割されています。