2.2.1　モジュールトレース（出力ディレクトリとファイル名）

ここでは，モジュールトレースの出力ディレクトリ，ファイル名，および出力タイミングについて説明します。

TPBrokerでは，稼働しているプロセス上にバッファを確保し，そこにモジュールトレース情報を記録します。バッファに記録されたモジュールトレース情報は，プロセスごとにあるタイミングでファイルに出力されます。

モジュールトレースは次の表のとおりに作成されます。

表2‒1　モジュールトレース（出力ディレクトリとファイル名の一覧）
項目名	ORBの種類
項目名	Java ORB	C++ ORB
出力ディレクトリ	${VBROKER_ADM}/../logj/mdltrc （%VBROKER_ADM%`\`..`\`logj`\`mdltrc）	${VBROKER_ADM}/../log/mdltrc （%VBROKER_ADM%`\`..`\`log`\`mdltrc）
ファイル名	<付加名称^※1>.<プロセスID>.<時刻情報^※2>.mdl.dat 付加名称デーモンまたはコマンドの場合だけ，付加されます。時刻情報環境変数HVI_TRACEFILENAME_TODで付加するかどうかを設定できます。	osagentの場合 osagent.<プロセスID>.<時刻情報^※2>.mdl.dat アプリケーションの場合 <実行形式ファイル名称>.<プロセスID>.<時刻情報^※2>.mdl.dat 時刻情報環境変数HVI_TRACEFILENAME_TODで付加するかどうかを設定できます。また，UNIXでは，次に示すファイル名の場合があります。 unknown.<プロセスID>.mdl.dat 次の場合だけです。 ORB_init()の引数argcに"0"を指定する ORB_init()の引数argvに"NULL"を指定する argv[0]に"NULL"を指定する argv[0]にハイフン（"-"）を指定する
作成タイミング	Windows ネーミングサービスを含むデーモン，またはコマンドの場合プロセス起動時アプリケーションの場合プロセスで最初にORB.init()を発行したとき UNIX プロセス終了時	Windows プロセス起動時 UNIX プロセス終了時

　: 出力ディレクトリの絶対パスの長さが，210 - (<実行形式ファイル名称の長さ（Java ORBの場合10）>)を超えると，付加名称が付加されない場合やファイル出力に失敗する場合があります。
注※2: 時刻情報は，ファイルが作成された時刻です。YYYYMMDDHHMMSS形式で付加されます。

モジュールトレース情報は，バッファの上限サイズまで出力されたあと，ラップアラウンドします。上限サイズは，環境変数HVI_MTRENTRYCOUNTで変更できます。

ファイルは，環境変数HVI_MTRFILECOUNTで指定した値（例えばn個とする）を最大数として生成され，更新時刻の古いものから順に削除します。ただし，以下の場合にファイルがn個を超えることがあります。