Debug: Testnachricht in Eingabewarteschlange einreihen

Zum Testen eines Nachrichtenflusses, für den Sie ein Debugging ausführen, können Sie eine Nachricht in eine Eingabewarteschlange einreihen.

Vor dem Start

Führen Sie die im Abschnitt Fluss-Debugger zur Durchführung eines Debug-Vorgangs an eine Ausführungsgruppe anhängen beschriebenen Schritte aus.

Wenn Ihr Nachrichtenfluss MQInput- und MQOutput-Knoten umfasst, können Sie zum Testen des Nachrichtenflusses eine Nachricht in die Eingabewarteschlange des ersten MQInput-Knotens einreihen.

Nachrichten können über die Befehlszeilenschnittstellen oder den WebSphere MQ-Explorer (bei WebSphere MQ Version 6) bzw. die WebSphere MQ-Services (bei WebSphere MQ Version 5.3) in Warteschlangen eingereiht werden.

Eine wiederholt anwendbare Alternative dazu bietet der Testclient. Führen Sie die in den folgenden Abschnitten beschriebenen Schritte aus, wenn Sie den Testclient verwenden möchten:

Wenn die Nachricht vom Nachrichtenfluss verarbeitet und in eine Ausgabewarteschlange eingereiht wird, kann sie von dort abgerufen werden. Weitere Informationen hierzu finden Sie im Abschnitt Debug: Testnachricht aus Ausgabewarteschlange abrufen.

Datei zur Warteschlangeneinreihung konfigurieren und verwenden

Gehen Sie wie folgt vor, um eine Datei zur Warteschlangeneinreihung so zu konfigurieren, dass über diese Datei eine Testnachricht gesendet werden kann:

  1. Wechseln Sie in die Ansicht 'Brokerverwaltung'.
  2. Klicken Sie in der Workbench-Symbolleiste auf den Pfeil auf dem Symbol Put a message onto a queue (Nachricht in eine Warteschlange einreihen) Nachricht in eine Warteschlange einreihen.
  3. Klicken Sie im Dropdown-Menü auf Put Message (Nachricht einreihen), um den Assistenten New Enqueue Message File (Neue Datei für Einreihung in Warteschlange) aufzurufen.
  4. Wählen Sie das Nachrichtenflussprojekt aus, das den Nachrichtenfluss enthält, für den Sie gerade den Debug ausführen.
  5. Geben Sie im Feld Dateiname einen Namen für die zu erstellende Datei ein. (Die Dateierweiterung .enqueue wird automatisch hinzugefügt.)
  6. Klicken Sie auf Fertigstellen. Die Datei zur Warteschlangeneinreihung wird erstellt, und eine Ansicht mit Einzelangaben zur Datei wird geöffnet.
  7. Geben Sie den Namen des Warteschlangenmanagers und der Warteschlange für den Empfangsknoten dieses Nachrichtenflusses ein. Bei Namen von Warteschlangenmanagern wird die Groß-/Kleinschreibung berücksichtigt; achten Sie darauf, dass Sie den Namen korrekt eingeben.

    Wenn Sie eine Nachricht in eine Eingabewarteschlange einreihen, die sich auf einem fernen Computer befindet, ist sicherzustellen, dass der Warteschlangenmanager des zugeordneten Brokers über einen Serververbindungskanal mit der Bezeichnung SYSTEM.BKR.CONFIG verfügt.

  8. Geben Sie Werte zur Identifikation des Hosts und Ports des Computers ein, auf dem die Warteschlange betrieben wird, falls Sie eine Nachricht in eine ferne Warteschlange einreihen.
  9. Optional: Klicken Sie auf die Registerkarte MQMD, um die Felder des MQMD-Headers anzupassen. Lesen Sie die Beschreibungen dieser Felder im Abschnitt Application Programming Reference des WebSphere MQ Version 6 Information Center online oder im Handbuch zu WebSphere MQ Version 5.3 auf der Webseite der Bibliothek zu WebSphere MQ; die Konstanten sind im Abschnitt Constants oder im Handbuch aufgeführt.
  10. Optional: Klicken Sie auf die Registerkarte Konfiguration und wählen Sie MQ-Nachrichtenheader aus, um die Felder des MQMD-Headers anzupassen. Lesen Sie die Beschreibungen dieser Felder im Abschnitt Application Programming Reference des WebSphere MQ Version 6 Information Center online; die Konstanten sind im Abschnitt Constants aufgeführt.

    Klicken Sie auf MQ-Nachrichtenheader "Standard-Header", um die Einstellungen für den Nachrichtenheader anzuzeigen, der für die Testnachricht verwendet wird. Sie können die Optionen für den Standard-Header bearbeiten oder alternativ einen neuen Header erstellen und bearbeiten:

    1. Klicken Sie auf MQ-Nachrichtenheader.
    2. Klicken Sie auf Hinzufügen, und geben Sie einen eindeutigen Namen für den Header ein.
    3. Bearbeiten Sie die Headereinstellungen.
    4. Klicken Sie auf die Registerkarte Ereignisse, und wählen Sie den geeigneten Header für die Nachricht in der Liste Header aus.
  11. Klicken Sie auf Datei > Speichern, um die Datei zu speichern.
  12. Optional: Klicken Sie auf Write to queue (In Warteschlange schreiben), wenn die Nachricht direkt von diesem Fenster aus in die Warteschlange eingereiht werden soll.
  13. Klicken Sie auf den Pfeil des Symbols Nachricht in Warteschlange einreihen Nachricht in Warteschlange einreihen, damit die Datei zur Einreihung in die Warteschlange in der Liste des Dropdown-Menüs angezeigt wird.
  14. Klicken Sie im Menü auf diese Datei (oder wenn sie in der Dateiliste an erster Stelle steht, klicken Sie direkt auf das Symbol), um eine Nachricht in die Warteschlange einzureihen. Wenn Sie entsprechende Unterbrechungspunkte eingerichtet haben, stoppt der Debugger den Nachrichtenfluss am nächsten Unterbrechungspunkt.

Wechseln Sie zur Ansicht 'Brokeranwendungsentwicklung', und erweitern Sie die Navigationsstruktur Ihres Nachrichtenflussprojekts, um Ihre Datei zur Einreihung in die Warteschlange später wiederzufinden. Doppelklicken Sie auf die für die Warteschlange bestimmte Datei, um sie in einer Ansicht zu öffnen.

Optional: Nachricht Daten hinzufügen

Wenn Sie Ihrer Testnachricht nur wenig Testdaten hinzufügen möchten, können Sie die Daten in das Fenster "Nachrichtendaten" eingeben:

  1. Öffnen Sie die Datei zur Einreihung in die Warteschlange und wählen Sie die Registerkarte Durchsuchen aus.
  2. Geben Sie die Testdaten direkt in das Fenster "Nachrichtendaten" ein.
  3. Reihen Sie die Testnachricht ein, indem Sie die Registerkarte Allgemein auswählen und auf Write to queue (In Warteschlange schreiben) (Nachricht senden) klicken.

Optional: Datei mit Musterdaten verwenden

Wenn Ihre Testnachricht eine größere Menge von Musterdaten (beispielsweise strukturierte XML-Daten) enthalten soll, erstellen oder importieren Sie zuerst eine Datei, die diese Daten enthält. Sorgen Sie dann dafür, dass diese Daten von der Datei für die Einreihung in die Warteschlange verwendet werden. Folgen Sie den optionalen Schritten, um nach einer der angegebenen Methoden Daten zu erstellen und hinzuzufügen.

Gehen Sie folgendermaßen vor, um die Datei zur Warteschlangeneinreihung zu veranlassen, eine Datei mit Musterdaten zu verwenden:

  1. Erstellen oder importieren Sie die Datei mit Nachrichtendaten wie unten beschrieben.
  2. Öffnen Sie Ihre Datei zur Warteschlangeneinreihung; klicken Sie bei Dateiname auf die Schaltfläche Durchsuchen.
  3. Wählen Sie im Fenster "Nachricht hinzufügen" Ihre Datei aus, und klicken Sie auf OK.
  4. Klicken Sie auf Datei > Speichern, wenn Sie die Aktion beendet haben.
  5. Wählen Sie die Registerkarte Durchsuchen im unteren Bereich der Ansicht 'Warteschlange' aus, um die Daten in Ihrer Datei anzuzeigen. Wenn Sie die Daten ändern möchten, geben Sie entweder Text in das Fenster "Nachrichtendaten" ein, oder klicken Sie in der Brokerentwicklungssicht doppelt auf die Datei, um sie zu bearbeiten.
    Tipp: Wenn Sie sich anstelle der Texteingabe versuchsweise für die Verwendung einer XML-Datei entscheiden, denken Sie daran, die Eigenschaften für den Empfangsknoten Ihres Nachrichtenflusses zu bearbeiten und die Nachrichtendomäne auf XML zu setzen. Wenn Ihre Nachricht im Flussdebugger der Variablenansicht angezeigt wird, wird die XML-Datei analysiert und kann in der Baumstruktur erweitert werden.

Optional: Datei mit Musterdaten für die Nachricht erstellen

Gehen Sie folgendermaßen vor, um eine neue Datei mit Musterdaten zu erstellen:

  1. Wechseln Sie zur Ansicht 'Brokeranwendungsentwicklung'.
  2. Klicken Sie nacheinander auf Datei > Neu > Sonstige.
  3. Klicken Sie zuerst auf Einfach und dann auf Datei.
  4. Wählen Sie im Fenster Neue Datei das Projekt aus, in dem Sie die Datei ablegen wollen, und geben Sie anschließend bei Dateiname einen Namen und eine Erweiterung für Ihre Datei ein. Wenn Ihre Datei XML-Daten enthält, muss die Dateierweiterung unbedingt .XML lauten.
  5. Klicken Sie auf Fertigstellen. Die Datei wird erstellt und erscheint in der Brokerentwicklungssicht. Mit einem entsprechenden Editor (Text oder XML) wird eine Dateiansicht geöffnet.
  6. Bearbeiten Sie die Datei, und geben Sie darin den gewünschten Text bzw. die gewünschten XML-Daten ein.
  7. Klicken Sie auf Datei > Speichern, wenn Sie die Aktion beendet haben.

Nun können Sie die Datei, wie im Abschnitt Optional: Datei mit Musterdaten verwenden beschrieben, auswählen. Sie können auch auf die Datei doppelklicken, um sie in einem geeigneten Editor zu öffnen.

Optional: vorhandene Datei mit Musterdaten für die Nachricht importieren

Wenn auf Ihrem Computer bereits eine Datei vorhanden ist, die Musterdaten enthält, welche Sie in einer Testnachricht verwenden wollen, führen Sie folgende Schritte aus, um die Daten in die Workbench zu importieren. Wenn die Datei XML-Daten enthält, muss sie unbedingt die Erweiterung .XML haben.

  1. Wechseln Sie zur Ansicht 'Brokeranwendungsentwicklung'.
  2. Klicken Sie auf Datei > Importieren.
  3. Wählen Sie in der Liste der Assistenten die Option Dateisystem aus, und klicken Sie anschließend auf Weiter.
  4. Klicken Sie bei Verzeichnis auf die Schaltfläche Durchsuchen. Navigieren Sie zu dem Ordner, in dem sich Ihre Datei befindet, und klicken Sie anschließend auf OK. Eine Liste mit den Dateien des Ordners wird angezeigt.
  5. Aktivieren Sie in der Dateiliste das Kontrollkästchen neben der zu importierenden Datei.
  6. Klicken Sie bei Ordner auf die Schaltfläche Durchsuchen, und wählen Sie das Projekt aus, in dem Sie die Datei ablegen wollen.,
  7. Klicken Sie auf Fertigstellen.

Wenn Sie die Datei wie hier beschrieben importiert haben, wird eine Kopie dieser Datei im Workbench-Datenraum zusammen mit allen anderen Workbench-Dateien für die Konfiguration gespeichert. Die Originaldatei selbst wird nicht direkt wiederverwendet.

Die Datei wird in der Brokerentwicklungssicht in dem ausgewählten Projekt angezeigt und kann von Ihnen wie im Abschnitt Optional: Datei mit Musterdaten verwenden auf dieser Seite beschrieben ausgewählt werden. Sie können auch doppelt auf die Datei klicken und sie in einem geeigneten Editor öffnen.

Zugehörige Konzepte
Übersicht zu Fluss-Debuggern
Bemerkungen | Marken | Downloads | Bibliothek | Unterstützung | Feedback

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

ag16710_