IBM MQ トレースの使用

IBM® MQ トレースを使用して、IBM MQ の実行内容に関する詳細情報を収集できます。

このタスクについて

通常は、IBM サービス担当員に依頼された場合にのみトレースを使用可能にします。トレースは IBM MQ をスローダウンし、トレース・ファイルは急速に非常に大きなものになります。

詳しくは、IBM Knowledge Center 内のstrmqtrcおよびendmqtrcを参照してください。

IBM MQ エクスプローラーを使用してトレースの開始または停止を行う操作は、制御コマンド strmqtrc -e または endmqtrc -e を使用する操作に相当します。いずれの場合も、指定されているキュー・マネージャーのすべてのプロセスのトレースが対象になります。

IBM MQ トレースでは、IBM MQ エクスプローラーはトレースされません。IBM MQ エクスプローラーのトレース方法について詳しくは、トラブルシューティングを参照してください。

トレースの開始

このタスクについて

トレース・サービスをオンにする方法は次のとおりです。

手順

  1. 「ナビゲーター」ビューで、 IBM MQ を右クリックしてから、 「トレース...」をクリックします。
  2. 「トレース」ダイアログで、以下のオプションの 1 つ以上を選択します。
    • システムのトレース・ポイントすべてのデータを出力するには、「すべて」を クリックします。
    • トレース・ポイントの処理フローに対して詳細レベルでのトレースを活動化する には、「詳細」をクリックします。
  3. 「開始」をクリックします。

タスクの結果

IBM MQ トレースにより、トレース・ファイルへの情報の書き込みが開始されます。 IBM MQ は、トレースが停止されるまでトレース・ファイルへの書き込みを継続します。

トレースの停止

このタスクについて

トレース・サービスをオフにする方法は次のとおりです。

手順

  1. 「ナビゲーター」ビューで、 IBM MQ を右クリックしてから、 「トレース...」をクリックします。
  2. 「停止」をクリックします。

タスクの結果

IBM MQ トレースは、トレース・ファイルへの書き込みを停止します。

トレース・ファイルの表示

このタスクについて

データ・ファイルのインストール時に選択されたディレクトリーの trace サブディレクトリーに、 ローカル・トレース・ファイルはあります。デフォルトのディレクトリーにインストールした場合、trace ディレクトリーは IBM MQ プログラムのインストール・ディレクトリーにあります。

trace ディレクトリー内のファイルには AMQ123.TRC のような名前が付けられます。ここで 123 はファイルを 書き込んだプロセスの PID です。ASCII ファイルを表示するビューアーを使用して、ファイルを表示することができます。