mcfttrc
形式
mcfttrc 〔-t "〔size=トレースバッファの大きさ〕 〔disk=yes|no〕 〔bufcnt=トレースバッファの数〕 〔trccnt=トレースファイルの数〕 〔msgsize=トレースとして取得する送受信メッセージ の最大サイズ〕"〕 〔-m del|off〕
機能
MCFのトレースに関する環境を定義します。
MCFトレースは，MCFに関する情報を取得し，トラブル解析用に使用します。
オプション
●-t
(オペランド)
- size=トレースバッファの大きさ 〜〈符号なし整数〉((4096〜15728640の4の倍数))《204800》（単位：バイト）
-
MCFトレースを格納するためのバッファの大きさを指定します。
通常は省略値を使ってください。
ユーザが指定した値によって，MCFは次の処理をします。
-
指定した値がMCFで定めた下限値より小さい場合，その値をMCFで定めた下限値に補正します。
-
指定した値がMCFで定めた上限値より大きい場合，その値をMCFで定めた上限値に補正します。
-
指定した値が4の倍数でない場合，その値を4の倍数になるように切り上げます。
指定値に応じて静的共用メモリの容量を見積もる必要があります。静的共用メモリの見積もりは，「付録B.2 MCFサービス用の共用メモリの見積もり式」を参照してください。
-
- disk=yes|no 〜《yes》
-
MCFトレースのディスク出力機能を使用するかどうかを指定します。
- yes
-
ディスク出力機能を使用します。MCFトレース情報でトレースバッファが満杯になった時に，バッファの内容をディスクに出力（スワップ）します。
MCFトレースファイルは，$DCDIR/spool/ディレクトリの下に，mcftXXXnn（XXXはMCF識別子，nnは通し番号）というファイル名で出力されます。
MCFトレースファイルの詳細については，マニュアル「OpenTP1 運用と操作」の「MCFトレースに関する運用」および「OpenTP1が出力するファイル一覧」の説明を参照してください。
なお，MCF通信プロセスおよびアプリケーション起動プロセスが異常終了したとき，最新トレース情報をmcftXXX0というファイルに出力する場合があります。このファイルは，trccntオペランドで指定するトレースファイルの数に含まれません。
- no
-
ディスク出力機能を使用しません。メモリにだけ出力します。
diskオペランドを省略した場合は，MCFトレースファイルを生成しません。メモリ上の2面バッファを交互に使用します。
また，diskオペランドを省略した場合は，次のbufcntオペランド，trccntオペランド，および-mオプションの指定は無効になります。
- bufcnt=トレースバッファの数 〜〈符号なし整数〉((10〜2147483647))《100》
-
トレースバッファの数を指定します。
MCFトレースファイルにトレースバッファを何面分格納するかを指定します。
なお，MCFトレースファイルの大きさが次の条件を満たすようにトレースバッファの大きさ（mcfttrc -t sizeの指定値）とトレースバッファの数（mcfttrc -t bufcntの指定値）を指定してください。
MCFトレースファイルの大きさ=トレースバッファの数（mcfttrc -t bufcntの指定値）×トレースバッファの大きさ（mcfttrc -t sizeの指定値）＜2147483648バイト
- trccnt=トレースファイルの数 〜〈符号なし整数〉((3〜99))《3》
-
MCFトレースファイルの数を指定します。
スワップ済みトレースファイル（bufcntオペランドで指定した数のスワップを終了したトレースファイル）とスワップ用トレースファイルの合計を指定します。
- msgsize=トレースとして取得する送受信メッセージの最大サイズ 〜〈符号なし整数〉((0〜1073741824))《128》（単位：バイト）
-
MCFはメッセージ受信時およびメッセージ送信時に，そのメッセージの一部またはすべてをトレースとして取得します。メッセージの先頭からどれだけの内容をトレースに取得するか，その最大サイズを指定します。
0を指定した場合，メッセージの内容をトレースに取得しません。メッセージのサイズがこの指定値より小さい場合は，メッセージのすべての内容をトレースとして取得します。
このオペランドは，TP1/NET/TCP/IPを使用したMCF通信サービスに対して有効です。
●-m del|off
〜《del》
スワップ済みトレースファイルの数と，trccntオペランドの指定値との関係を指定します。
- del
-
スワップ済みトレースファイルの数と，trccntオペランドの指定値が一致した場合，いちばん古いスワップ済みトレースファイルを削除し，そのファイル名でスワップ用トレースファイルを作成します。
- off
-
trccntオペランドの指定値を無視します。スワップ済みトレースファイルの数が99になった場合，いちばん古いスワップ済みトレースファイルを削除し，そのファイル名でスワップ用トレースファイルを作成します。
ディスクの空き容量を圧迫しますので，スワップ済みトレースファイルは，運用者の責任で処理したあと，削除してください。