runwithtrace コマンドのバリアントを使用することにより、独自の Eclipse 環境または Eclipseベースの製品にインストールされている IBM® MQ Explorer のインスタンスからトレースを収集できます。
作業を始める前に
このタスクは、 IBM MQ エクスプローラー が独自の Eclipse 環境または Eclipseベースの製品にインストールされているため、 IBM MQ Explorer トレースの収集で説明されている標準の 実行トレース コマンドを使用できないことを前提としています。
本タスクについて
IBM MQ エクスプローラー は、独自の Eclipse 環境または Eclipseベースの製品にインストールして、 Java アプリケーションの開発や独自の拡張機能の開発に役立てることができます。
トレースを収集するには、 runwithtrace コマンドを使用して IBM MQ エクスプローラーを開始します。 この製品で提供されている runwithtrace コマンドは使用できません。 代わりに、次の手順で説明されているように、コマンドのバリアントを使用します。
注: 通常、トレースを有効にするのは、 IBM サービス担当員から依頼された場合のみです。 トレースにより IBM MQ エクスプローラー の速度が低下し、トレース・ファイルが急速に大きくなる可能性があります。
手順
- IBM MQ Explorer トレース・メカニズムは、インストールされる AspectJ プラグインおよび Equinox Weaving プラグインに依存します。 これらのプラグインがインストールされていることは、次のようにして確認できます。
- 「ヘルプ」 をクリックします。
- 「バージョン情報」をクリックします。
- 「インストールの詳細」をクリックします。
- 「プラグイン」 タブをクリックします。
org.eclipse.equinox.weaving.caching.j9
プラグインはもう存在しませんが、 IBM MQ 9.0.4より前の IBM MQ 9.0 長期サポートまたは IBM MQ 9.0 継続的デリバリー リリースを使用している場合は、このプラグインが必要です。
以下のプラグインがインストールされていることを確認してください。
org.aspectj.runtime
org.aspectj.weaver
org.eclipse.equinox.weaving.aspectj
org.eclipse.equinox.weaving.caching
org.eclipse.equinox.weaving.caching.j9
org.eclipse.equinox.weaving.hook
- まだインストールされていない場合、AspectJ プラグインと Equinox Weaving プラグインをインストールします。 これらのプラグインは、使用している Eclipse のバージョンに一致している必要があり、Eclipse AspectJ 開発ツールのダウンロード・サイトからダウンロードできます。 ご使用のバージョンの Eclipseに使用するダウンロード・サイトを判別するには、 https://projects.eclipse.org/projects/tools.ajdtを参照してください。
AspectJ プラグインと Equinox Weaving プラグインをインストールするには、以下のサブステップを実行します。
- 「ヘルプ」 をクリックし、 「新規ソフトウェアのインストール ...」をクリックします。
- 「追加 ...」 をクリックします。 Eclipse バージョンに適したダウンロード・サイトの場所を入力します。
例えば、Eclipse 4.4 の場合は https://download.eclipse.org/tools/ajdt/44/dev/update と入力します。
- 「OK」をクリックします。
使用可能なソフトウェアのリストが表示されます。
- 「その他の AJDT ツール (オプション) (Other AJDT Tools (Optional))」 カテゴリーを展開し、 「AspectJ Compiler and Equinox Weaving SDK」を選択します。
- 「次へ」 をクリックして、ウィザードの指示に従います。
- トレース IBM MQ エクスプローラー。
runwithtrace スクリプトを使用して、 IBM MQ エクスプローラー を閉じて再始動します。 Windows オペレーティング・システムで使用するスクリプトについては、 runwithtrace command script for Windowsを参照してください。 Linux® オペレーティング・システムで使用するスクリプトについては、 Linuxを参照してください。
このスクリプトは、Eclipse 実行可能ファイルが含まれているディレクトリーから実行する必要があります。
runwithtrace コマンドを使用して IBM MQ エクスプローラー を開始すると、 IBM MQ エクスプローラーのトレースを有効にする追加のパラメーターが組み込まれます。 runwithtrace コマンド自体はパラメーターを必要としないことに注意してください。
トレース・ファイルの実際の出力場所は以下の理由で異なるため、コマンドの実行時にその場所がコマンド行に出力されます。
IBM MQ エクスプローラー ・トレース・ファイルの名前の形式は、トレース・セッションの開始時刻を示す AMQYYYYMMDDHHmmssmmm.TRC.n です。 トレース・ファイルが最大サイズに達すると、トレース機能により、そのセッションのすべてのトレース・ファイルは、ファイル接尾部 .n が 1 つずつ増えるように名前変更されます。 その後、最新のトレースを含む接尾部 .0 の付いた新規ファイルがトレース機能によって作成されます。
- AspectJ プラグインと Equinox Weaving プラグインをアンインストールします。 IBM MQ エクスプローラー ・トレースを終了すると、 Eclipse 環境から AspectJ プラグインと Equinox Weaving プラグインを削除できます。 AspectJ プラグインと Equinox Weaving プラグインは、次のようにしてアンインストールします。
- 「ヘルプ」 をクリックして、 「バージョン情報 ...」をクリックします。
- 「インストールの詳細」 をクリックしてから、 「インストール済みソフトウェア」 タブをクリックします。
- 項目「 AspectJ Complier 」と「 Equinox Weaving SDK」を選択します。
- 「アンインストール ...」 をクリックします。 ウィザードの指示に従います。