他の Eclipse 環境での IBM MQ Explorer トレースの収集

runwithtrace コマンドのバリアントを使用すると、独自の Eclipse 環境または Eclipseベースの製品にインストールされている IBM® MQ Explorer のインスタンスからトレースを収集できます。

始める前に

このタスクは、 IBM MQ Explorer が独自の Eclipse 環境または Eclipseベースの製品にインストールされているため、 IBM MQ Explorer トレースの収集で説明されている標準の runwithtrace コマンドを使用できないことを前提としています。

本タスクについて

IBM MQ Explorer は、独自の Eclipse 環境または Eclipseベースの製品にインストールして、 Java アプリケーションの開発や独自の拡張機能の開発に役立てることができます。

トレースを収集するには、 runwithtrace コマンドを使用して IBM MQ Explorerを開始します。 この製品で提供されている runwithtrace コマンドは使用できません。 代わりに、次の手順で説明されているように、コマンドのバリアントを使用します。

注: 通常、トレースを有効にするのは、 IBM サービス担当員から依頼された場合のみです。 トレースによって IBM MQ Explorer の速度が低下し、トレース・ファイルが急速に大きくなる可能性があります。

手順

  1. IBM MQ Explorer トレース・メカニズムは、インストールされる AspectJ および Equinox Weaving プラグインに依存します。 これらのプラグインがインストールされていることは、次のようにして確認できます。
    1. 「ヘルプ」 をクリックします。
    2. 「バージョン情報」をクリックします。
    3. 「インストールの詳細」をクリックします。
    4. 「プラグイン」 タブをクリックします。
    org.eclipse.equinox.weaving.caching.j9 プラグインはもう存在しませんが、IBM MQ 9.0.4 より前の IBM MQ 9.0 Long Term Support リリースまたは IBM MQ 9.0 Continuous Delivery リリースを使用している場合は、このプラグインが必要になります。
    以下のプラグインがインストールされていることを確認してください。
    
    	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
    
  2. まだインストールされていない場合、AspectJ プラグインと Equinox Weaving プラグインをインストールします。 これらのプラグインは、使用している Eclipse のバージョンに一致している必要があり、Eclipse AspectJ 開発ツールのダウンロード・サイトからダウンロードできます。 ご使用のバージョンの Eclipseに使用するダウンロード・サイトを判別するには、 https://projects.eclipse.org/projects/tools.ajdtを参照してください。

    IBM MQ Explorer が構築されている Eclipse レベルについては、 What 's new and what 's changed in IBM MQ Explorerを参照してください。

    現在、それらのビルドは開発ビルドとしてのみ使用できます。使用可能な最新のものを選択してください。

    AspectJ プラグインと Equinox Weaving プラグインをインストールするには、以下のサブステップを実行します。
    1. 「ヘルプ」 をクリックし、 「新規ソフトウェアのインストール ...」をクリックします。
    2. 「追加 ...」 をクリックします。 Eclipse バージョンに適したダウンロード・サイトの場所を入力します。
      例えば、Eclipse 4.4 の場合は https://download.eclipse.org/tools/ajdt/44/dev/update と入力します。
    3. 「OK」をクリックします。
      使用可能なソフトウェアのリストが表示されます。
    4. 「その他の AJDT ツール (オプション) (Other AJDT Tools (Optional))」 カテゴリーを展開し、 AspectJ 「Compiler and Equinox Weaving SDK」を選択します。
    5. 「次へ」 をクリックして、ウィザードの指示に従います。
  3. トレース IBM MQ Explorer

    runwithtrace スクリプトを使用して、 IBM MQ Explorer を閉じて再始動します。 Windows オペレーティング・システムで使用するスクリプトについては、 Windows の runwithtrace コマンド・スクリプトを参照してください。 Linux® オペレーティング・システムで使用するスクリプトについては、 Linuxを参照してください。

    このスクリプトは、Eclipse 実行可能ファイルが含まれているディレクトリーから実行する必要があります。

    runwithtrace コマンドを使用して IBM MQ Explorer を開始すると、 IBM MQ Explorerのトレースを有効にする追加のパラメーターが組み込まれます。 runwithtrace コマンド自体はパラメーターを必要としないことに注意してください。

    トレース・ファイルの実際の出力場所は以下の理由で異なるため、コマンドの実行時にその場所がコマンド行に出力されます。
    • IBM MQ インストールの状況に依存する
    • ユーザー権限

    IBM MQ Explorer トレース・ファイルの名前の形式は AMQYYYYMMDDHHmmssmmm.TRC.n で、これはトレース・セッションの開始時刻を示します。 トレース・ファイルが最大サイズに達すると、トレース機能は、ファイル接尾部 .n を 1 つ増分することによって、セッションのすべてのトレース・ファイルを名前変更します。 その後、トレース機能は、最新のトレースを含む接尾部 .0 を持つ新規ファイルを作成します。

  4. AspectJ プラグインと Equinox Weaving プラグインをアンインストールします。 IBM MQ Explorer トレースを終了すると、 Eclipse 環境から AspectJ プラグインと Equinox Weaving プラグインを削除できます。 AspectJ プラグインと Equinox Weaving プラグインは、次のようにしてアンインストールします。
    1. 「ヘルプ」 をクリックして、 「バージョン情報 ...」をクリックします。
    2. 「インストールの詳細」 をクリックしてから、 「インストール済みソフトウェア」 タブをクリックします。
    3. 項目 AspectJ Complier および Equinox Weaving SDKを選択します。
    4. 「アンインストール ...」 をクリックします。 ウィザードの指示に従います。