Mit dem MQReply-Knoten können Sie eine Antwort an den Absender der Eingabenachricht senden.
Dieses Kapitel enthält folgende Abschnitte:
Der MQReply-Knoten ist eine spezielle Form des MQOutput-Knotens, der die Ausgabenachricht in die WebSphere MQ-Warteschlange stellt, die im Feld 'ReplyToQ' des Headers der Eingabenachricht angegeben ist. Falls angebracht, definieren Sie die Warteschlange als WebSphere MQ-Clusterwarteschlange oder als gemeinsam genutzte Warteschlange.
Der MQReply-Knoten verwendet die Berichtsoptionen, die im Feld 'Bericht' des MQMD festgelegt sind. Wenn keine Optionen festgelegt sind, generiert der MQReply-Knoten standardmäßig eine neue MsgId (Nachrichten-ID) und CorrelId (Korrelations-ID) in der Antwortnachricht. Wenn die empfangende Anwendung in diesen Feldern andere Werte erwartet, müssen Sie sicherstellen, dass die Anwendung, von der die Nachricht in die Eingabewarteschlange des Nachrichtenflusses gestellt wird, die erforderlichen Berichtsoptionen festlegt oder dass Sie während der Nachrichtenverarbeitung im Nachrichtenfluss im MQMD die entsprechenden Optionen festlegen. Sie können die Berichtsoptionen beispielsweise über einen Compute-Knoten festlegen.
Weitere Informationen zum Feld 'Bericht' finden Sie im Abschnitt
Application Programming Reference im
WebSphere MQ Version 6 Information Center online oder im Version
5.3-Handbuch auf der Webseite der Bibliothek zu WebSphere MQ.
Der MQReply-Knoten ist in der WebSphere MQ-Ablage der Palette enthalten und wird in der Workbench durch folgendes Symbol dargestellt:
Sie können diesen Knoten verwenden, wenn Sie einen Auftrag von einem Kunden erhalten. Sobald die Auftragsnachricht verarbeitet ist, wird eine Antwort an den Kunden gesendet, in der der Empfang des Auftrags bestätigt und ein mögliches Lieferdatum genannt wird.
Nachdem Sie eine Instanz des MQReply-Knotens in einen Nachrichtenfluss eingereiht haben, können Sie den Knoten konfigurieren; siehe Nachrichtenflussknoten konfigurieren. Die Eigenschaften des Knotens werden in der Ansicht 'Eigenschaften' angezeigt. Klicken Sie zum Anzeigen der Eigenschaften des Knotens im Dialogfenster 'Eigenschaften' entweder doppelt auf den Knoten, oder klicken Sie mit der rechten Maustaste auf den Knoten und dann im Kontextmenü auf Eigenschaften.
Alle obligatorischen Eigenschaften, für die Sie einen Wert eingeben müssen (d. h. Eigenschaften ohne definierten Standardwert), sind mit einem Sternchen gekennzeichnet.
Konfigurieren Sie den MQReply-Knoten wie folgt:
Weitere Informationen zu
den Optionen, zu denen diese Eigenschaft eine Zuordnung durchführt, finden Sie im Abschnitt
Application Programming Reference im
WebSphere MQ Version 6 Information Center online oder im Version
5.3-Handbuch auf der Webseite der Bibliothek zu WebSphere MQ.
Sie finden weitere Informationen hierzu in den Abschnitten Nachrichten überprüfen und Auswertungseigenschaften.
Die Antwortnachricht wird (mittels MQPUT) in die Warteschlange eingereiht, die im MQMD der Eingabenachricht als ReplyTo-Warteschlange benannt wurde. Diese Zieladresse kann nicht geändert werden.
Schließen Sie das Ausgabe- oder Fehlerterminal dieses Knotens an einen anderen Knoten in diesem Nachrichtenfluss an, um die Nachricht weiterzuverarbeiten, Fehler zu behandeln oder die Nachricht an eine weitere Zieladresse zu senden.
Wenn Sie keines dieser Ausgabeterminals verbinden, bleibt die Baumstruktur für die lokale Umgebung unverändert.
Wenn Sie in Ihren Nachrichtenflüssen aggregieren, müssen Sie diese Ausgabeterminals verwenden.
In der folgenden Tabelle werden die Terminals des MQReply-Knotens beschrieben.
Terminal | Beschreibung |
---|---|
Eingangsterminal | Das Eingangsterminal, das eine Nachricht zur Verarbeitung durch einen Knoten annimmt |
Fehlerterminal | Das Ausgabeterminal, an das die Nachricht geleitet wird, wenn ein Fehler beim Einreihen der Nachricht in die Ausgabewarteschlange festgestellt wird |
Ausgabeterminal | Das Ausgabeterminal, an das die Nachricht geleitet wird, wenn sie erfolgreich in die Ausgabewarteschlange gestellt wurde und falls in diesem Nachrichtenfluss eine weitere Verarbeitung erforderlich ist |
In den folgenden Tabellen werden die Knoteneigenschaften beschrieben. Die Spalte O zeigt an, ob die Eigenschaft obligatorisch ist (markiert mit einem Sternchen, wenn ein Wert eingegeben werden muss, weil kein Standardwert definiert ist). Die Spalte K zeigt an, ob die Eigenschaft konfigurierbar ist (Wert kann geändert werden, wenn der Nachrichtenfluss zur BAR-Datei hinzugefügt wird, um ihn einzusetzen).
In der folgenden Tabelle werden die Beschreibungseigenschaften des MQReply-Knotens beschrieben.
Eigenschaft | O | K | Standardwert | Beschreibung |
---|---|---|---|---|
Knotenname | Nein | Nein | Knotentyp | Der Name des Knotens. |
Kurzbeschreibung | Nein | Nein | Eine Kurzbeschreibung des Knotens. | |
Ausführliche Beschreibung | Nein | Nein | Text, der den Zweck des Knotens im Nachrichtenfluss beschreibt. |
In der folgenden Tabelle werden die erweiterten Eigenschaften des MQReply-Knotens beschrieben.
Eigenschaft | O | K | Standardwert | Beschreibung |
---|---|---|---|---|
Segmentierung zulässig | Ja | Nein | Nicht ausgewählt | Wenn Sie dieses Kontrollkästchen aktivieren, teilt WebSphere MQ die Nachricht im WS-Manager in verschiedene Segmente auf. |
Permanenzmodus | Ja | Nein | Automatisch | Durch diese Eigenschaft wird gesteuert, ob die Nachricht permanent eingereiht wird. Gültige Werte sind Automatisch, Ja, Nein und Wie für Warteschlange definiert. |
Transaktionsmodus | Ja | Nein | Automatisch | Durch diese Eigenschaft wird gesteuert, ob die Nachricht transaktionsorientiert eingereiht wird. Gültige Werte sind Automatisch, Ja und Nein. |
In der folgenden Tabelle werden die Auswertungseigenschaften des MQReply-Knotens beschrieben.
Eine umfassende Beschreibung dieser Eigenschaften finden Sie unter Auswertungseigenschaften.
Eigenschaft | O | K | Standardwert | Beschreibung |
---|---|---|---|---|
Auswerten | Nein | Ja | Übernehmen | Durch diese Eigenschaft wird gesteuert, ob eine Auswertung stattfindet. Gültige Werte sind Keine, Inhalt und Wert, Inhalt und Übernehmen. |
Aktion bei Fehler | Nein | Nein | Ausnahme | Durch diese Eigenschaft wird gesteuert, was beim Fehlschlagen der Auswertung geschieht. Sie können diese Eigenschaft nur angeben, wenn Sie Auswerten auf Inhalt oder Inhalt und Wert gesetzt haben. Gültige Werte sind Benutzertrace, Lokales Fehlerprotokoll, Ausnahmebedingung und Ausnahmeliste. |
Alle Wertvorgaben einschließen | Ja | Nein | Ausgewählt | Diese Eigenschaft kann nicht bearbeitet werden. Wenn Sie dieses Kontrollkästchen aktivieren, werden bei der Auswertung von Inhalt und Wert auch Basisprüfungen der Wertvorgaben durchgeführt. |
Korrektur | Ja | Nein | Keines | Diese Eigenschaft kann nicht bearbeitet werden. |
Der MQReply-Knoten verfügt auch über die folgenden Eigenschaften, die Sie über die Workbench-Schnittstelle nicht aufrufen oder modifizieren können. Diese Werte werden jedoch vom Broker verwendet, wenn die Nachricht im Nachrichtenfluss verarbeitet wird.
Eigenschaft | Beschreibung |
---|---|
Name des WS-Managers | Name des WebSphere MQ-Warteschlangenmanagers, für den die unter Name der Warteschlange angegebene Ausgabewarteschlange definiert ist. Dieser Name wird aus dem Feld 'ReplyTo' des MQMD der Eingabenachricht abgerufen. |
Name der Warteschlange | Der Name der WebSphere MQ-Warteschlange, in die die Ausgabenachricht eingereiht wird. Dieser Name wird aus dem Feld 'ReplyTo' des MQMD der Eingabenachricht abgerufen. |
Zieladresse | Diese Eigenschaft hat immer den Wert reply (Antwort). |