Testnachricht einreihen

Vor dem Start

Führen Sie folgende Task aus:

In diesem Abschnitt wird erklärt, wie Sie eine Testnachricht als Debughilfe verwenden können. Er enthält folgende Abschnitte:

Einführung

Damit Sie mit dem Debug Ihres Nachrichtenfluss beginnen können, ist es ratsam, den Nachrichtenfluss dadurch auszulösen, dass Sie eine Testnachricht in die Eingabewarteschlange Ihres ersten MQEmpfangsknotens einreihen. In diesem Abschnitt erfahren Sie, wie Sie durch Konfiguration und Verwendung einer Datei für die Einreihung in eine Warteschlange eine Testnachricht in die Workbench einreihen können. Diese Methode zur Einreihung von Nachrichten bietet eine einfache und reproduzierbare Alternative zur Verwendung des WebSphere MQ-Explorers bzw. der Befehlszeilenschnittstelle.

Tipp: Außerdem werden in diesem Abschnitt verschiedene Möglichkeiten aufgezeigt, wie Testdaten zu einer Nachricht hinzugefügt werden können. Wenn Sie eine Testnachricht mit nur wenigen Testdaten senden wollen, geben Sie die Daten in ein Fenster ein. 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 Anweisungen in den als optional gekennzeichneten Abschnitten und den folgenden Schritten, um nach einer der angegebenen Methoden Daten zu erstellen und hinzuzufügen.

So konfigurieren und verwenden Sie eine Datei zur Einreihung in die Warteschlange

Gehen Sie folgendermaßen vor, um eine Datei zur Einreihung in die Warteschlange so zu konfigurieren, dass Sie damit eine Testnachricht senden können:

  1. Wechseln Sie zur Ansicht 'Debug'.
  2. Klicken Sie in der Workbench-Symbolleiste auf den Pfeil auf dem Symbol Nachricht in Warteschlange einreihen Nachricht in Warteschlange einreihen.
  3. Klicken Sie im Dropdown-Menü auf Nachricht einreihen, um den Assistenten 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 Fertig stellen. 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.
  8. Bei Version 6.0 ist es möglich, eine Nachricht in eine ferne Warteschlange einzureihen. Geben Sie Werte ein, um den Host und Port auf dem Computer zu kennzeichnen, der die Warteschlange hostet.
  9. Klicken Sie auf Datei > Speichern, um die Datei zur Einreihung in die Warteschlange zu speichern.
  10. Optional: Klicken Sie auf die Schaltfläche In Warteschlange schreiben, um die Nachricht direkt von diesem Fenster aus in die Warteschlange einzureihen.
  11. Klicken Sie auf den Pfeil des Symbols Nachricht in Warteschlange einreihenNachricht in Warteschlange einreihen, damit die Datei zur Einreihung in die Warteschlange in der Liste des Dropdown-Menüs angezeigt wird.
  12. 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. Klicken Sie doppelt auf die für die Warteschlange bestimmte Datei, um sie in einer Ansicht zu öffnen.

Optional: So fügen Sie Daten zu Ihrer Nachricht hinzu

Gehen Sie folgendermaßen vor, um einer Nachricht schnell ein paar Testdaten hinzuzufügen:

  1. Öffnen Sie die Datei zur Einreihung in die Warteschlange, und wählen Sie die Registerkarte Durchsuchen aus.
  2. Geben Sie Ihre Testdaten direkt in das Fenster "Nachrichtendaten" ein.
  3. Wählen Sie die Registerkarte Allgemein aus, und klicken Sie auf die Schaltfläche In Warteschlange einreihen, um die Testnachricht einzureihen.

Optional: So verwenden Sie eine Datei mit Musterdaten

Gehen Sie folgendermaßen vor, um die Datei für die Einreihung in die Warteschlange zur Verwendung einer Musterdatendatei abzurufen, die Sie, wie in den beiden folgenden Abschnitten beschrieben, erstellt oder importiert haben:

  1. Öffnen Sie Ihre Datei zur Warteschlangeneinreihung; klicken Sie bei Dateiname auf die Schaltfläche Durchsuchen.
  2. Wählen Sie im Fenster "Nachricht hinzufügen" Ihre Datei aus, und klicken Sie auf OK.
  3. Klicken Sie auf Datei > Speichern, wenn Sie die Aktion beendet haben.
  4. 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 wollen, geben Sie entweder Text in das Fenster "Nachrichtendaten" ein, oder klicken Sie in der Ansicht 'Ressourcennavigator' 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 Ansicht Variablenansicht angezeigt wird, wird die XML-Datei analysiert und kann in der Baumstruktur erweitert werden.

Optional: So erstellen Sie eine Datei mit Musterdaten für die Nachricht

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 Fertig stellen. Die Datei wird erstellt und in der Ansicht 'Ressourcennavigator' angezeigt. 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: So fügen Sie Daten zu Ihrer Nachricht hinzu beschrieben, auswählen. Sie können auch doppelt auf die Datei klicken, um sie in einem geeigneten Editor zu öffnen.

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

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.

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

Gehen Sie folgendermaßen vor, um eine vorhandene Datei mit Musterdaten zu importieren:

  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 Markierungsfeld 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 Fertig stellen.

Die Datei wird im Ressourcennavigator in dem von Ihnen ausgewählten Projekt angezeigt, und Sie können sie, wie im Abschnitt Optional: So fügen Sie Daten zu Ihrer Nachricht hinzu auf dieser Seite beschrieben, auswählen. Sie können auch doppelt auf die Datei klicken und sie in einem geeigneten Editor öffnen.

Zugehörige Konzepte
Flussdebugger - Übersicht
Bemerkungen | Marken | Downloads | Bibliothek | Unterstützung | Rückmeldung
Copyright IBM Corporation 1999, 2005 Letzte Aktualisierung: Nov 17, 2005
ag16710_