Tracefunktion von IBM MQ Explorer in anderen Eclipse-Umgebungen verwenden

Sie können IBM® MQ Explorer in Ihrer eigenen Eclipse-Umgebung oder in Ihrem eigenen Eclipse-basierten Produkt installieren, um Java™-Anwendungen oder eigene Erweiterungen zu entwickeln.

Informationen zu diesem Vorgang

Sie können IBM MQ Explorer-Traces erfassen, wenn Sie IBM MQ Explorer in Ihrem eigenen Eclipse- oder Eclipse-basierten Produkt installiert haben, indem Sie die nachfolgenden Anweisungen ausführen.

Es wird empfohlen, die Tracefunktion nur zu aktivieren, wenn Sie von Ihrem zuständigen IBM Ansprechpartner dazu aufgefordert werden. Durch die Durchführung von Traces wird der Betrieb von IBM MQ Explorer verlangsamt und die Tracedateien können unter Umständen schnell an Größe zunehmen.

Vorgehensweise

  1. Das IBM MQ Explorer-Traceverfahren erfordert die Installation von AspectJ- und Equinox Weaving-Plug-ins. So überprüfen Sie deren Installation:
    1. Klicken Sie auf Hilfe.
    2. Klicken Sie auf Informationen zu....
    3. Klicken Sie auf Installationsdetails.
    4. Klicken Sie auf die Registerkarte Plug-ins.
    [V9.0.4 Oct 2017]Das Plug-in org.eclipse.equinox.weaving.caching.j9 gibt es nicht mehr, aber Sie benötigen dieses Plug-in, wenn Sie IBM MQ Version 9.0 Long Term Support- oder IBM MQ Version 9.0 Continuous Delivery-Releases vor Version 9.0.4 verwenden. Stellen Sie sicher, dass folgende Plug-ins installiert sind:
    	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. Wenn sie nicht bereits installiert sind, installieren Sie die AspectJ- und Equinox Weaving-Plug-ins. Diese Plug-ins müssen der von Ihnen verwendeten Version von Eclipse entsprechen und können von der Download-Site für Eclipse AspectJ-Entwicklungstools heruntergeladen werden. Informationen dazu, welche Download-Site Sie für Ihre Eclipse-Version verwenden sollten, finden Sie unter https://www.eclipse.org/ajdt/downloads/. [V9.0.4 Oct 2017]Wenn Sie Eclipse 4.4.2 verwenden, müssen Sie AJDT 2.2.4 (nicht AJDT 2.2.3) verwenden. Diese Anweisung gilt, wenn Sie IBM MQ Version 9.0 Long Term Support- oder IBM MQ Version 9.0 Continuous Delivery-Releases vor Version 9.0.4 verwenden.

    IBM MQ Version 9.0.4 verwendet Eclipse 4.6.3. Wenn Sie Eclipse 4.6.3 verwenden, müssen Sie einen Build von der AJDT-Site abrufen, der mit Eclipse 4.6 kompatibel ist.

    Aktuell sind diese Builds nur als Entwicklungs-Builds verfügbar; wählen Sie den neuesten verfügbaren Build aus.

    Zur Installation der AspectJ- und Equinox Weaving-Plug-ins führen Sie die folgenden Unterschritte aus:
    1. Klicken Sie auf Hilfe und anschließend auf Neue Software installieren.
    2. Klicken Sie auf Hinzufügen... und geben Sie danach die Adresse der Download-Site für Ihre Eclipse-Version ein. Geben Sie z. B. für Eclipse 4.4 die URL http://download.eclipse.org/tools/ajdt/44/dev/update ein.
    3. Klicken Sie auf OK. Daraufhin wird eine Liste mit verfügbarer Software angezeigt.
    4. Erweitern Sie die Kategorie Andere AJDT-Tools (optional) und wählen Sie AspectJ Compiler and Equinox Weaving SDK aus.
    5. Klicken Sie auf Weiter und folgen Sie den Anweisungen des Assistenten.
  3. Zur Traceerstellung in IBM MQ Explorer schließen Sie IBM MQ Explorer und starten Sie das Programm mit dem Befehl runwithtrace erneut. Informationen zu dem für Windows-Betriebssysteme zu verwendenden Script finden Sie im Abschnitt Befehlsscript runwithtrace für Windows. Informationen zu dem für Linux-Betriebssysteme zu verwendenden Script finden Sie im Abschnitt Befehlsscript runwithtrace für Linux.

    Das Script muss in dem Verzeichnis ausgeführt werden, in dem die ausführbare Eclipse-Datei gespeichert ist.

    Wenn Sie IBM MQ Explorer mit dem Befehl runwithtrace starten, werden zusätzliche Parameter eingebunden, die das Tracing von IBM MQ Explorer ermöglichen. Beachten Sie, dass der Befehl runwithtrace selbst keine Parameter besitzt.

    Die Ausgabeposition der Tracedatei wird in der Befehlszeile ausgegeben, während der Befehl ausgeführt wird, da die tatsächliche Position von folgenden Faktoren abhängig ist:
    • dem Status der IBM WebSphere MQ-Installation
    • den Benutzerberechtigungen

    Der Name der Tracedateien von  IBM MQ Explorer hat das Format AMQJJJJMMTTHHmmssmmm.TRC.n, welches die Zeit angibt, zu der die Tracesitzung gestartet wurde. Wenn eine Tracedatei ihre maximale Größe erreicht, benennt die Tracefunktion alle Tracedateien der Sitzung um, indem das Dateisuffix .n um 1 erhöht wird. Anschließend erstellt die Tracefunktion eine neue Datei mit dem Suffix .0. Diese Datei enthält den neuesten Trace.

  4. Deinstallieren Sie die AspectJ- und Equinox Weaving-Plug-ins. Wenn Sie das IBM MQ Explorer-Tracing beendet haben, können Sie die AspectJ- und Equinox Weaving-Plug-ins aus der Eclipse-Umgebung entfernen. So deinstallieren Sie die AspectJ- und Equinox Weaving-Plug-ins:
    1. Klicken Sie auf Hilfe und anschließend auf Informationen zu....
    2. Klicken Sie auf Installationsdetails und anschließend auf die Registerkarte Installierte Software.
    3. Wählen Sie die Elemente AspectJ Complier und Equinox Weaving SDK aus.
    4. Klicken Sie auf Deinstallieren... und folgen Sie den Anweisungen des Assistenten.

Anleitung Anleitung

Feedback

Timestamp icon Letzte Aktualisierung: 6. Februar 2018
http://www.ibm.com/support/knowledgecenter/SSFKSJ_9.0.0/com.ibm.mq.explorer.doc/com.ibm.mq.explorer.doc/e_troubleshooting_trace_other.htm