xmscheck コマンド
目的
xmscheck コマンドは、記録構成ファイルを事前構文解析したり、実行中の xmtopas デーモンを記録用に構成する方法を決定したりするために使用できます。
構文
xmscheck [ file_name ]
説明
コマンド・ライン引数 -v を指定して xmtopas コマンドが開始されると、その記録構成ファイル・パーサーは、構文解析の結果をログ・ファイルに書き込みます。 出力には、記録構成ファイル内のすべての行のコピー、エラー・メッセージ、および、記録の開始時刻と停止時刻を示す時間目盛りのマップが含まれます。
これは、記録構成ファイルから読み取られるデータを文書化するのに役立ちますが、新規または変更された記録構成ファイルのデバッグに役立つツールではありません。 そのため、xmtopas コマンドが記録構成ファイルを探す /etc/perf ディレクトリーに、ユーザーが記録構成ファイルを移動する前に、プログラム xmscheck コマンドを使用してその記録構成ファイルを事前構文解析しておくことができます。
コマンド・ライン引数なしで xmscheck コマンドが開始されると、このコマンドは /etc/perf/xmservd.cf ファイルを構文解析します。 この方法で、実行中のデーモンがどのように記録用に構成されているかを判別することができます。 ファイル名がコマンド・ラインに指定されている場合は、そのファイルが構文解析されます。
xmscheck コマンドからの出力先は、標準出力です。 構文解析は、xmtopas コマンド内で構文解析を行うモジュールとまったく同じモジュールによって行われます。 そのモジュールは、両方のプログラムの一部としてリンクされています。 構文解析では、すべての指定された統計情報が有効かどうか検査され、記録の開始時刻と停止時刻を示す時間目盛りが「タイムテーブル」の形式で印刷されます。
タイムテーブルでは、分ごとに数字コードがあります。 コードの意味は、以下のとおりです。
| 項目 | 説明 |
|---|---|
| 0 | 記録は非アクティブです。 この分については、開始要求も停止要求も設定されませんでした。 |
| 1 | 記録はアクティブです。 この分については、開始要求も停止要求も設定されませんでした。 |
| 2 | 記録は非アクティブです。 この分については、停止要求が設定されました。 |
| 3 | 記録はアクティブです。 この分については、開始要求が設定されました。 |
例
以下の例では、xmscheck コマンドがどのようにタイムテーブルの形式設定を行うかを示します。 このテーブルは、火曜日の部分のみを示しています。
Day 2, Hour 00: 000000000000000000000000000000000000000000000000000000000000
Day 2, Hour 01: 000000000000000000000000000000000000000000000000000000000000
Day 2, Hour 02: 000000000000000000000000000000000000000000000000000000000000
Day 2, Hour 03: 000000000000000000000000000000000000000000000000000000000000
Day 2, Hour 04: 000000000000000000000000000000000000000000000000000000000000
Day 2, Hour 05: 000000000000000000000000000000000000000000000000000000000000
Day 2, Hour 06: 000000000000000000000000000000000000000000000000000000000000
Day 2, Hour 07: 000000000000000000000000000000000000000000000000000000000000
Day 2, Hour 08: 000000000000000000000000000000311111111111111111111111111111
Day 2, Hour 09: 111111111111111111111111111111111111111111111111111111111111
Day 2, Hour 10: 111111111111111111111111111111111111111111111111111111111111
Day 2, Hour 11: 111111111111111111111111111111111111111111111111111111111111
Day 2, Hour 12: 200000000000000000000000000000000000000000000000000000000000
Day 2, Hour 13: 311111111111111111111111111111111111111111111111111111111111
Day 2, Hour 14: 111111111111111111111111111111111111111111111111111111111111
Day 2, Hour 15: 111111111111111111111111111111111111111111111111111111111111
Day 2, Hour 16: 111111111111111111111111111111111111111111111111111111111111
Day 2, Hour 17: 200000000000000000000000000000000000000000000000000000000000
Day 2, Hour 18: 000000000000000000000000000000000000000000000000000000000000
Day 2, Hour 19: 000000000000000000000000000000000000000000000000000000000000
Day 2, Hour 20: 000000000000000000000000000000000000000000000000000000000000
Day 2, Hour 21: 000000000000000000000000000000000000000000000000000000000000
Day 2, Hour 22: 000000000000000000000000000000000000000000000000000000000000
Day 2, Hour 23: 000000000000000000000000000000000000000000000000000000000000