Fluss-Debugger zur Durchführung eines Debug-Vorgangs an eine Ausführungsgruppe anhängen

Bevor Sie in Ihrem Nachrichtenfluss Fehler beheben können, müssen Sie den Debugger an die Ausführungsgruppe anhängen, in der sich Ihr Nachrichtenfluss befindet und anschließend eine Debugsitzung starten.

Bevor Sie beginnen:

Sie können den Fluss-Debugger von einer einzelnen Workbench an mehrere Ausführungsgruppen anhängen, die auf demselben bzw. auf verschiedenen Host-Computern ausgeführt werden, und in deren Nachrichtenflüssen (und somit mehreren Nachrichten) dann gleichzeitig Fehler beheben.

Beginn der ÄnderungFür eine Ausführungsgruppe kann der Debugger nur jeweils von einem Benutzer ausgeführt werden. Wenn Sie Ihren Debugger an eine Ausführungsgruppe anhängen, kann deshalb ein anderer Benutzer erst einen Debugger an dieselbe Ausführungsgruppe anhängen, wenn Sie Ihre Debugsitzung beendet haben.Ende der Änderung

Der Fluss-Debugger kann Debugs für Laufzeitbroker früherer Versionen ausführen. 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.

Ausführliche Informationen dazu, welche Version des Rational Agent Controller auf den einzelnen Brokerbetriebssystemen installiert werden muss, finden Sie unter Rational Agent Controller installieren.

Sie können den Debugger nicht für Flüsse ausführen, die Sie in eine 64-Bit-Ausführungsgruppe implementiert haben. Der Fluss-Debugger unterstützt nur 32-Bit-Ausführungsgruppen.

Gehen Sie folgendermaßen vor, um den Debugger an eine Ausführungsgruppe anzuhängen:

  1. Wechseln Sie in die Ansicht 'Brokerverwaltung'. Achten Sie auf den Namen des Nachrichtenflusses, der im Teilfenster Domänen angezeigt wird.
  2. Ö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.
  3. Fügen Sie einen Unterbrechungspunkt zu einer Verbindung hinzu, die aus dem Empfangsknoten hinausführt, um sicherzustellen, 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 Fluss-Debugger mit Unterbrechungspunkten arbeiten.

  4. Wechseln Sie zur Ansicht 'Debug'.
  5. Klicken Sie in der Symbolleiste auf den Abwärtspfeil auf dem Symbol Debug Debug starten, und klicken Sie auf Debug, um den Debugassistenten (Konfigurationen erstellen, verwalten und ausführen) aufzurufen.
    Sie erstellen nun 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. Diese Aktion generiert einen Fehler, wenn eine der folgenden Bedingungen zutrifft:
    • Sie haben bisher keine Debug-Startkonfiguration erstellt.
    • Der Broker und die Ausführungsgruppe, die zuvor zugeordnet wurden, sind nicht mehr aktiv.
    • Der Broker und die Ausführungsgruppe wurden neu gestartet und haben aus diesem Grund eine neue Prozess-ID (siehe unten).
  6. 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.

    Die Schaltfläche Debug kann erst ausgewählt werden, wenn Sie die Felder in der Anzeige Verbinden ausgefüllt haben. Anschließend können Sie die Felder in den anderen Fenstern ausfüllen oder direkt auf Debug klicken.

    Der Assistent enthält folgende Fenster:
    • Verbinden: In diesem Fenster können Sie eine Verbindung über den Rational Agent Controller zur Ausführungsgruppe herstellen. Sie können Debug zum Starten einer Debugsitzung erst dann auswählen, wenn Sie alle Felder in dieser Anzeige ausgefüllt haben.
      Portnummer des Agentencontrollers
      Geben Sie die zu verwendende Portnummer ein.
      Flussprojekt
      Wählen Sie Ihr Flussprojekt aus.
      HostName
      Wählen Sie den Hostcomputer aus, auf dem die Ausführungsgruppe ausgeführt wird. Wenn der Host nicht aufgelistet ist, geben Sie den Hostnamen bzw. die IP-Adresse des Hostcomputers im Feld Hostname an (falls das Feld Hostname nicht verfügbar ist, klicken Sie zuerst auf Reset, und nehmen Sie dann die Änderungen vor).
      Ausführungsgruppe
      Wählen Sie den Broker und die Ausführungsgruppe aus, die Sie debuggen möchten. Wenn Sie auf die Schaltfläche Durchsuchen klicken, öffnet sich ein Listenfeld, in dem jede Ausführungsgruppe als Prozess-ID gefolgt vom Namen des Brokers und der Ausführungsgruppe (hier als Steuerkomponentenname bezeichnet) durch einen Doppelpunkt getrennt, angezeigt wird. Beispiel:
      Prozess-ID    Name der Engine
      ---------    ---------------
      5984         WMBV6BR:default
      Wenn die Ausführungsgruppe nicht im Listenfeld aufgeführt wird, klicken Sie auf Aktualisieren, um das aktualisierte Listenfeld mit den Namen aller Ausführungsgruppen anzuzeigen, die zurzeit auf dem Hostcomputer implementiert und verfügbar sind. Sollte die Ausführungsgruppe noch immer nicht im Listenfeld angezeigt werden, versuchen Sie, den RAC auf dem Hostcomputer neu zu starten.

      Sie haben nun die Möglichkeit, zu jeder Ausführungsgruppe, die auf dem Zielhost ausgeführt wird, eine Verbindung herzustellen. Sie können diesen Vorgang auch für Ausführungsgruppen ausführen, für die keine Flüsse implementiert sind.

      Die Prozessnummer ist die Windows-PID, die im Task-Manager auf der Seite Prozesse aufgeführt ist. Beim Implementieren laut Beschreibung in Publish/Subscribe-Topologie implementieren wurde die PID im Ereignisprotokoll erfasst.

      Klicken Sie entweder auf Debug, um mit dem nächsten Schritt fortzufahren, oder füllen Sie die Felder in den anderen Fenstern aus.

      Um ein Debugging für einen JavaCompute- oder einen benutzerdefinierten Java-Knoten durchzuführen, müssen Sie die JVM des Brokers mit einer Debug-Portnummer konfigurieren. Legen Sie diesen Wert mit folgendem Befehl fest (in einer Zeile):

      mqsichangeproperties <Brokername> -e <Ausführungsgruppenname>
       -o ComIbmJVMManager -n jvmDebugPort -v <Portnummer>
      Starten Sie nach Beendigung dieses Befehls den Broker neu.
  7. Klicken Sie auf Debug. In der Ansicht 'Debug' werden der Name des ausgewählten Host-Computers und der Name der Ausführungsgruppe angezeigt.
  8. Wenn die nächste Nachricht den Nachrichtenfluss erreicht und am Unterbrechungspunkt ankommt, den Sie hinter dem Empfangsknoten hinzugefügt haben, wird der Fluss angehalten und das Symbol des Unterbrechungspunkts wird hervorgehoben: Aktivierter, angehaltener Unterbrechungspunkt. Sie können nun mit dem Debug beginnen.
  9. 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 jetzt weitere Unterbrechungspunkte hinzufügen, damit beginnen, den Nachrichtenfluss Schritt für Schritt durchzugehen, und so weiter.

Weitere Schritte:

Fahren Sie mit einer der folgenden Tasks fort:

Zugehörige Konzepte
Übersicht zu Fluss-Debuggern
Zugehörige Tasks
Rational Agent Controller installieren
Implementieren
Debugger für Nachrichtenfluss ausführen
Debug: Sitzung beenden
Zugehörige Verweise
Direktaufrufe für Fluss-Debugger
Symbole für Fluss-Debugger
Bemerkungen | Marken | Downloads | Bibliothek | Unterstützung | Feedback

Copyright IBM Corporation 1999, 2009Copyright IBM Corporation 1999, 2009.
Letzte Aktualisierung : 2009-02-17 15:29:15

ag11186_