Dieses Thema ist in folgende Abschnitte eingeteilt:
Verwenden Sie den MQAntwortknoten, um eine Antwort an den Sender der Eingabenachricht zu schicken. Der MQAntwortknoten ist eine spezielle Form des MQSendeknotens, welcher die Ausgabennachricht in der WebSphere MQ-Warteschlange einreiht, die durch das ReplyToQ-Feld des Eingabenachrichtenheaders identifiziert wird. Falls passend, können Sie die Warteschlange als eine WebSphere MQ-Clusterwarteschlange oder als gemeinsam genutzte Warteschlange definieren.
Der MQAntwortknoten berücksichtigt die Optionsgruppe im Berichtsfeld im MQMD. Der MQAntwortknoten generiert standardmäßig (wenn keine Optionen angegeben werden) eine neue Nachrichten-ID und Korrelations-ID in der Antwortnachricht. Wenn die empfangende Anwendung andere Werte in diesen Feldern erwartet, müssen Sie sicherstellen, dass entweder die Anwendung, welche die Nachricht in die Eingabewarteschlange des Nachrichtenflusses einreiht, die erforderlichen Berichtsoptionen angibt, oder dass Sie die entsprechenden Optionen im MQMD während der Nachrichtenverarbeitung im Nachrichtenfluss angeben. Legen Sie beispielsweise die Berichtsoptionen in der Nachricht mit Hilfe eines Rechenknotens fest.
Weitere Informationen zum Feld 'Bericht' finden Sie im Handbuch WebSphere MQ Application Programming Reference.
Der MQAntwortknoten wird in der Workbench durch das folgende Symbol dargestellt:
Im folgenden Beispiel ist zu sehen, wie dieser Knoten verwendet werden kann:
Die Verwendung dieses Knotens ist von Nutzen, wenn Sie einen Auftrag von einem Kunden erhalten. Bei der Verarbeitung der Auftragsnachricht wird eine Antwort an den Kunden gesendet, die den Erhalt des Auftrags bestätigt und ein mögliches Lieferdatum angibt.
Wenn Sie eine Instanz des MQAntwortknotens in einen Nachrichtenfluss eingereiht haben, können Sie sie konfigurieren. Klicken Sie in der Editoransicht mit der rechten Maustaste auf den Knoten, und wählen Sie dann Eigenschaften. Es werden die Grundeigenschaften des Knotens angezeigt.
Alle verbindlichen Eigenschaften, für die Sie einen Wert eingeben müssen (diejenigen, für die kein Standardwert definiert ist), sind im Eigenschaftendialog mit einem Stern markiert.
Konfigurieren Sie den MQAntwortknoten wie folgt:
Weitere Informationen zu den Optionen, zu denen diese Eigenschaft eine Zuordnung durchführt, finden Sie im Handbuch WebSphere MQ Application Programming Reference.
Sie finden detaillierte Informationen hierzu unter Nachrichten prüfen und Eigenschaften der Gültigkeitsprüfung für Nachrichten in der MRM-Domäne.
Klicken Sie auf Abbrechen, um den Dialog zu schließen und alle Änderungen zu verwerfen, die Sie an den Eigenschaften durchgeführt hatten.
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.
Verbinden Sie das Ausgangs- oder Fehlerterminal dieses Knotens mit einem anderen Knoten in diesem Nachrichtenfluss, wenn Sie die Nachricht weiterverarbeiten, Fehler verarbeiten oder die Nachricht an eine zusätzliche Zieladresse senden möchten.
Wenn Sie eines dieser Ausgabeterminals mit einem anderen Knoten im Nachrichtenfluss verbinden, wird die mit dieser Nachricht verbundene lokale Umgebung erweitert und weist die folgenden Informationen für jede Zieladresse auf, für die diese Nachricht eingereiht wurde:
Diese Werte werden in das Verzeichnis 'WrittenDestination' der LocalEnvironment-Baumstruktur geschrieben.
Wenn Sie keines dieser Ausgangsterminals verbinden, bleibt die Baumstruktur der lokalen Umgebung unverändert.
Wenn Sie in Ihren Nachrichtenflüssen eine Aggregation verwenden, müssen Sie diese Ausgangsterminals nutzen.
Wenn Sie einen MQAntwortknoten definieren, bestimmt die Option, die Sie für die Eigenschaft Transaktionsmodus auswählen, ob die Nachricht unter dem Synchronisationspunkt geschrieben wird:
Eine andere Eigenschaft des MQAntwortknotens - Persistenzmodus - bestimmt, ob die Ausgabenachricht als persistent markiert wird, wenn sie in die Ausgabewarteschlange eingereiht wird:
Die Terminals des MQAntwortknotens werden in der folgenden Tabelle beschrieben.
Terminal | Beschreibung |
---|---|
Eingabeterminal | Das Eingabeterminal, das eine Nachricht für die Verarbeitung durch den Knoten akzeptiert. |
Fehlerterminal | Das Ausgabeterminal, an das die Nachricht weitergeleitet wird, wenn ein Fehler entdeckt wird, wenn die Nachricht in der Ausgabewarteschlange eingereiht wird. |
Ausgabeterminal | Das Ausgabeterminal, an das die Nachricht weitergeleitet wird, wenn sie erfolgreich in die Ausgabewarteschlange eingereiht wurde und wenn eine weitere Verarbeitung in diesem Nachrichtenfluss erforderlich ist. |
Die folgenden Tabellen beschreiben die Knoteneigenschaften; die Spalte mit der Überschrift 'O' gibt an, dass die Eigenschaft obligatorisch ist (beim Eigenschaftendialog mit einem Stern markiert, wenn Sie einen Wert eingeben müssen, falls kein Standardwert definiert ist); die Spalte mit der Überschrift 'K' gibt an, ob die Eigenschaft konfigurierbar ist (Sie können den Wert ändern, wenn Sie den Nachrichtenfluss der BAR-Datei hinzufügen, um sie einzusetzen).
Die erweiterten Eigenschaften des MQAntwortknotens werden in der folgenden Tabelle beschrieben.
Eigenschaft | O | K | Standardwert | Beschreibung |
---|---|---|---|---|
Segmentierung zulässig | Ja | Nein | Gelöscht | Falls angebracht, teilt WebSphere MQ die Nachricht im Warteschlangenmanager in Segmente auf. Wenn Sie das Markierungsfeld auswählen, wird diese Aktion ausgeführt. |
Persistenzmodus | Ja | Nein | Automatisch | Persistente Einreihung der Nachricht. Gültige Werte sind Automatisch, Ja, Nein und Wie für Warteschlange definiert. |
Transaktionsmodus | Ja | Nein | Automatisch | Transaktionsorientierte Einreihung der Nachricht. Gültige Werte sind Automatisch, Ja und Nein. |
In der nachfolgenden Tabelle werden die Auswertungseigenschaften des MQSendeknotens beschrieben.
Der Abschnitt Eigenschaften der Gültigkeitsprüfung für Nachrichten in der MRM-Domäne enthält eine ausführliche Beschreibung dieser Eigenschaften.
Eigenschaft | O | K | Standardwert | Beschreibung |
---|---|---|---|---|
Auswerten | Ja | Ja | Übernehmen | Durchführung einer Auswertung. Gültige Werte sind Keine, Inhalt und Wert, Inhalt und Übernehmen. |
Aktion bei Fehler | Ja | Nein | Ausnahme | Aktion beim Fehlschlagen einer Gültigkeitsprüfung. 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. Die Standardaktion (ausgewähltes Markierungsfeld) besteht darin, dass in der Auswertung von Inhalt und Wert auch Basisprüfungen der Wertvorgaben ausgeführt werden. |
Korrektur | Ja | Nein | Keine | Diese Eigenschaft kann nicht bearbeitet werden. |
Die Beschreibungseigenschaften des MQAntwortknotens werden in der folgenden Tabelle beschrieben.
Eigenschaft | O | K | Standardwert | Beschreibung |
---|---|---|---|---|
Kurzbeschreibung | Nein | Nein | Eine Kurzbeschreibung des Knotens. | |
Ausführliche Beschreibung | Nein | Nein | Text, der den Zweck des Knotens im Nachrichtenfluss beschreibt. |
Der MQAntwortknoten 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 | Der Name des WebSphere MQ-Warteschlangenmanagers, für den die in Name der Warteschlange identifizierte Ausgabewarteschlange definiert ist. Dieser Name wird vom ReplyTo-Feld des MQMD der Eingabenachricht abgerufen. |
Name der Warteschlange | Der Name der WebSphere MQ-Warteschlange, in welche die Ausgabenachricht eingereiht wird. Dieser Name wird vom ReplyTo-Feld des MQMD der Eingabenachricht abgerufen. |
Zieladresse | Diese Eigenschaft hat immer den Wert reply. |