An Nachrichtenfluss-Steuerkomponente zum Debugging anhängen

Vorbereitungen:

Um diese Task abzuschließen, müssen Sie zuerst folgende Tasks ausführen:

Bevor Sie in Ihrem Nachrichtenfluss Fehler beheben können, müssen Sie den Debugger an die Fluss-Steuerkomponente (Ausführungsgruppe) anhängen, in der sich der Nachrichtenfluss befindet, und dann die Debugsitzung starten. Sie können den Debugger auch an mehrere Nachrichtenflussengines anhängen, die auf demselben bzw. auf verschiedenen Hostsystemen ausgeführt werden, und in ihren Nachrichtenflüssen dann gleichzeitig Fehler beheben.

Führen Sie folgende Schritte aus, um den Debugger an die Nachrichtenflussengine anzuhängen:

  1. Starten Sie den Broker nach Abschluss des Befehls erneut.
  2. Wechseln Sie in die Ansicht 'Brokerverwaltung'. Achten Sie auf den Namen des Nachrichtenflusses im Teilfenster Domänen.
  3. Es muss eine Nummer für den Port für die Java-Fehlerbehebung angegeben werden.

    Um die Broker-JVM mit einer Debug-Portnummer für diesen Wert zu konfigurieren, können Sie entweder auf die Schaltfläche 'Ausführungsgruppe auswählen' klicken, mit der rechten Maustaste auf die ausgewählte Ausführungsgruppe klicken und dann auf 'Einstellungen' klicken, oder Sie können folgenden Befehl ausgeben (alles in einer einzigen Zeile):

    mqsichangeproperties <Brokername> -e <Name_der_Ausführungsgruppe> -o ComIbmJVMManager -n jvmDebugPort -v <Portnummer>

    Starten Sie nach Beendigung dieses Befehls den Broker neu.

  4. Öffnen Sie den Nachrichtenfluss, für den Sie den Debugger ausführen möchten, im Nachrichtenflusseditor, indem Sie doppelt auf den Namen im Teilfenster Brokerverwaltungsnavigator klicken.
  5. Fügen Sie einen Unterbrechungspunkt zu einer Verbindung hinzu, die aus dem Empfangsknoten des Nachrichtenflusses hinausführt. Durch das Hinzufügen dieses Unterbrechungspunkts stellen Sie sicher, dass der Nachrichtenfluss nicht abgeschlossen wird, bevor Sie mit dem Debug beginnen können.

    Der Unterbrechungspunkt wird als aktivierter Unterbrechungspunkt angezeigt. Informationen zum Hinzufügen eines Unterbrechungspunkts finden Sie unter Im Debugger mit Unterbrechungspunkten arbeiten.

  6. Wechseln Sie zur Ansicht 'Debug'.
  7. Klicken Sie in der Symbolleiste auf den Abwärtspfeil auf dem Symbol Debug Debug starten, und wählen Sie Debug aus, um den Debugassistenten (Konfigurationen erstellen, verwalten und ausführen) aufzurufen.
    Tipp: Sie erstellen eine Debug-Startkonfiguration. Falls Sie bereits eine erstellt haben, können Sie sie erneut starten, indem Sie direkt auf das Debug-Symbol Debug starten klicken. Dieser Vorgang löst einen Fehler aus, wenn eine der folgenden Bedingungen zutrifft:
    • Sie haben keine Debug-Startkonfiguration erstellt.
    • Der Broker und die Ausführungsgruppe, die Sie vorher angehängt haben, sind nicht mehr aktiv.
    • Der Broker und die Ausführungsgruppe wurden neu gestartet und haben aus diesem Grund eine neue Prozess-ID (s. unten).
  8. Klicken Sie in der Liste der Konfigurationen auf Nachrichtenbroker - Fehlerbehebung und anschließend auf Neu. Daraufhin werden mehrere Registerkarten angezeigt. Die erste Registerkarte heißt Verbinden.
    Tipp: Die Schaltfläche Debug kann erst ausgewählt werden, wenn Sie die Felder in der Anzeige Verbinden ausgefüllt haben. Danach können Sie die Felder in den anderen Anzeigen ausfüllen oder direkt auf Debug klicken.
    Im Assistenten werden folgende Fenster angezeigt:
    1. Einstellung für Java-Fehlerbehebung: In diesem Fenster können Sie Fehler in einem Nachrichtenfluss beheben. Beim Java-Port handelt es sich um die Portnummer, die Sie für die Broker-JVM angegeben haben. Wenn Sie keinen Port angeben, wird der Java-Debug inaktiviert.
    2. JVM-Debug-Port für den Broker einstellen
    3. Klicken Sie auf die Schaltfläche Ausführungsgruppe auswählen, um eine Liste mit Ausführungsgruppen anzuzeigen. Die Ausführungsgruppen werden im Fenster Implementierungsstelle des Testclients definiert.
    4. Quelle: Diese Anzeige zeigt dem Debugger an, wo er während des Debugs nach den Fluss-, Zuordnungs-, ESQL- oder Java-Quelldateien suchen soll. Beim Suchpfad kann es sich um den Namen eines Eclipse-Projekts, einen externen Ordner oder eine komprimierte Datei (ZIP-Datei) handeln. Die Angabe mehrerer Speicherpositionen ist möglich, jedoch sucht der Debugger immer zuerst in dem Nachrichtenflussprojekt, das Sie in der Anzeige Verbinden angegeben haben.
    5. Allgemein: Diese Anzeige wird nicht direkt vom Fluss-Debugger verwendet; dort festgelegte Optionen sind jedoch wirksam. Weitere Informationen finden Sie im Abschnitt Workbench User Guide.
  9. Klicken Sie auf Debug. In der Ansicht 'Debug' werden der Name des ausgewählten Hostcomputers und der Name der Nachrichtenflussengine angezeigt.
  10. Wenn die nächste Nachricht den Nachrichtenfluss erreicht und am Unterbrechungspunkt ankommt, wird der Fluss angehalten, und das Symbol des Unterbrechungspunkts ändert sich in Aktivierter, angehaltener Unterbrechungspunkt. Sie können nun mit dem Debug beginnen.
  11. Klicken Sie in der Ansicht 'Debug' doppelt auf den Nachrichtenfluss, für den Sie den Debugger ausführen möchten. Der Nachrichtenfluss wird im Nachrichtenflusseditor geöffnet. Sie können nun weitere Unterbrechungspunkte hinzufügen, damit beginnen, den Fluss von Unterbrechungspunkt zu Unterbrechungspunkt durchzugehen usw.
Tipp: Der Debugger kann von einer einzelnen Workbench aus mit mehreren Ausführungsgruppen verbunden werden. So kann der Debugger für mehrere Nachrichtenflüsse in verschiedenen Ausführungsgruppen (und damit für mehrere Nachrichten) gleichzeitig ausgeführt werden. Für einen Nachrichtenfluss, der nur in einer Ausführungsgruppe implementiert ist, kann der Debugger jedoch immer nur von einem Benutzer zur Zeit ausgeführt werden. D. h. wenn Sie Ihren Debugger daran anhängen, kann kein anderer Benutzer gleichzeitig einen Debugger anhängen.

Der Fluss-Debugger kann Debugs für Laufzeitbroker früherer Versionen ausführen. Sie wählen Sie die Version des Brokers aus, den Sie debuggen möchten, indem Sie die entsprechende Option in der Anzeige Auswahl der Steuerkomponente des Debug-Assistenten wie zuvor beschrieben auswählen.

Nachdem Sie diese Task beendet haben, können Sie mit einer der folgenden Tasks fortfahren:

Zugehörige Konzepte
Übersicht zu Fluss-Debuggern
Zugehörige Tasks
Implementieren
Debugger für Nachrichtenfluss ausführen
Debug: von der Fluss-Steuerkomponente abhängen
Zugehörige Verweise
Direktaufrufe für Fluss-Debugger
Symbole für Fluss-Debugger
Bemerkungen | Marken | Downloads | Bibliothek | Unterstützung | Rückmeldung
Copyright IBM Corporation 1999, 2007 Letzte Aktualisierung: Jan 24, 2008
ag11186_