IBM MQ Explorer -Trace in anderen Eclipse -Umgebungen erfassen

Wenn Sie eine Variante des Befehls runwithtrace verwenden, können Sie einen Trace von einer Instanz von IBM® MQ Explorer erfassen, die in Ihrer eigenen Eclipse -Umgebung oder einem Eclipse-basierten Produkt installiert ist.

Bevor Sie beginnen

Diese Task setzt voraus, dass Sie IBM MQ -Explorer in Ihrer eigenen Eclipse -Umgebung oder in Ihrem Eclipse-basierten Produkt installiert haben und daher nicht den 'runwithtrace' -Standardbefehl wie in IBM MQ Explorer-Trace erfassenbeschrieben verwenden können.

Informationen zu dieser Task

IBM MQ Explorer kann in Ihrer eigenen Eclipse -Umgebung oder in einem Eclipse-basierten Produkt installiert werden, um die Entwicklung von Java -Anwendungen oder die Entwicklung eigener Erweiterungen zu unterstützen.

Zum Erfassen von Traces verwenden Sie einen Befehl runwithtrace , um IBM MQ Explorerzu starten. Sie können den Befehl runwithtrace, der mit dem Produkt bereitgestellt wird, nicht verwenden. Stattdessen verwenden Sie eine Variante des Befehls, wie in der folgenden Prozedur beschrieben.

Hinweis: Sie aktivieren die Traceerstellung normalerweise nur, wenn Sie von Ihrem IBM Ansprechpartner dazu aufgefordert werden. Die Traceerstellung verlangsamt den IBM MQ Explorer und die Tracedateien können schnell groß werden.

Verfahren

  1. Der IBM MQ Explorer -Tracemechanismus beruht auf der Installation von AspectJ-und Equinox Weaving-Plug-ins. So überprüfen Sie deren Installation:
    1. Klicken Sie auf Hilfe .
    2. Klicken Sie auf Produktinfo ...
    3. Klicken Sie auf Installationsdetails
    4. Klicken Sie auf die Registerkarte Plug-ins .
    Das org.eclipse.equinox.weaving.caching.j9 -Plug-in ist nicht mehr vorhanden, Sie benötigen dieses Plug-in, wenn Sie IBM MQ 9.0 Langfristige Unterstützungoder IBM MQ 9.0 Continuous Delivery -Releases vor IBM MQ 9.0.4verwenden.
    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 für Ihre Version von Eclipseverwendet werden soll, finden Sie unter https://projects.eclipse.org/projects/tools.ajdt.

    Informationen zur Version von Eclipse , auf der IBM MQ Explorer basiert, finden Sie unter Neuerungen und Änderungen in IBM MQ Explorer.

    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 ... . Geben Sie anschließend die Position der Download-Site für die Eclipse-Version ein.
      Geben Sie z. B. für Eclipse 4.4 die URL https://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 Other AJDT Tools (Optional) und wählen Sie AspectJ Compiler and Equinox Weaving SDKaus.
    5. Klicken Sie auf Weiter und folgen Sie den Anweisungen des Assistenten.
  3. Trace IBM MQ Explorer.

    Schließen Sie IBM MQ Explorer mithilfe des Scripts runwithtrace und starten Sie es erneut. Informationen zu dem Script, das für Windows -Betriebssysteme verwendet wird, finden Sie unter Befehlsscript 'runwithtrace' für Windows. Informationen zu dem für Linux® -Betriebssysteme zu verwendenden Script finden Sie unter 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 integriert, die die Traceerstellung von IBM MQ Exploreraktivieren. Beachten Sie, dass der Befehl runwithtrace selbst keine Parameter besitzt.

    Die Ausgabeposition der Tracedatei wird in die Befehlszeile ausgegeben, wenn der Befehl ausgeführt wird, da die tatsächliche Position von Folgendem abhängig ist:
    • den Status der IBM MQ -Installation.
    • Benutzerberechtigungen.

    Die IBM MQ Explorer -Tracedateien haben einen Namen im Format AMQYYMMDDHHmmssmmm.TRC.n , der die Startzeit der Tracesitzung angibt. 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. Nach Abschluss des IBM MQ Explorer -Trace 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 Produktinfo ....
    2. Klicken Sie auf Installationsdetails und anschließend auf die Registerkarte Installierte Software .
    3. Wählen Sie die Elemente AspectJ Complier und Equinox Weaving SDKaus.
    4. Klicken Sie auf Deinstallieren ... und folgen Sie den Anweisungen des Assistenten.