IBM MQ Explorer-Trace in anderen Eclipse-Umgebungen erfassen

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

Vorbereitungen

Diese Task setzt voraus, dass Sie IBM MQ Explorer in Ihrer eigenen Eclipse -Umgebung oder in Ihrem Eclipse-basierten Produkt installiert haben. Daher kann der Standardbefehl runwithtrace nicht verwendet werden, wie im Abschnitt Trace für IBM MQ Explorer erfassenbeschrieben.

Informationen zu dieser Task

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

Zum Erfassen des Trace verwenden Sie den 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 vom IBM Ansprechpartner dazu aufgefordert werden. Die Traceerstellung verlangsamt 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 jedoch, wenn Sie IBM MQ 9.0 Long Term Support oder IBM MQ 9.0 Continuous Delivery-Releases, die älter sind als IBM MQ 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 für Ihre Version von Eclipseverwendet werden soll, finden Sie unter https://projects.eclipse.org/projects/tools.ajdt.

    Informationen zur Eclipse , auf der IBM MQ Explorer basiert, finden Sie im Abschnitt 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 und starten Sie das Script runwithtrace erneut. Informationen zu dem Script, das für Windows -Betriebssysteme verwendet werden soll, finden Sie unter runwithtrace command script for Windows. Informationen zu dem Script, das für Linux® -Betriebssysteme verwendet wird, finden Sie unter runwithtrace command script for 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 für 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:
    • Status der IBM MQ-Installation.
    • Benutzerberechtigungen.

    Die IBM MQ Explorer-Tracedateien haben einen Namen im Format AMQYYYYMMDDHHmmssmmm.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.