MQAntwortknoten

Dieses Thema ist in folgende Abschnitte eingeteilt:

Zweck

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:

Symbol für den MQAntwortknoten

Verwendung dieses Knotens in einem Nachrichtenfluss

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.

Den MQAntwortknoten konfigurieren

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:

  1. Wählen Sie das Kontrollkästchen Segmentierung zulässig aus, wenn WebSphere MQ die Nachricht im Warteschlangenmanager segmentieren soll, falls angebracht. Sie müssen MQMF_SEGMENTATION_ALLOWED im MsgFlags-Feld im MQMD festlegen, damit die Segmentierung durchgeführt wird.

    Weitere Informationen zu den Optionen, zu denen diese Eigenschaft eine Zuordnung durchführt, finden Sie im Handbuch WebSphere MQ Application Programming Reference.

  2. Wählen Sie den gewünschten Persistenzmodus für die Ausgabenachricht.
    • Wenn Sie Automatisch (die Standardeinstellung) auswählen, ist die Persistenz so, wie sie in der eingehenden Nachricht angegeben ist.
    • Wählen Sie Ja aus, wird die Nachricht persistent eingereiht.
    • Wählen Sie Nein aus, wird die Nachricht nicht persistent eingereiht.
    • Wenn Sie Wie für Warteschlange definiert wählen, wird die Nachrichtenpersistenz so festgelegt, wie in der WebSphere MQ-Warteschlange definiert wurde.
  3. Wählen Sie den gewünschten Transaktionsmodus für die Ausgabenachricht.
    • Wenn Sie Automatisch (die Standardeinstellung) auswählen, wird die Transaktionsorientierung der Nachricht von der Art abgeleitet, die beim MQEmpfangsknoten angegeben wurde.
    • Wählen Sie Ja aus, wird die Nachricht transaktionsorientiert eingereiht.
    • Wählen Sie Nein aus, wird die Nachricht nicht transaktionsorientiert eingereiht.
  4. Wählen Sie im Eigenschaften-Dialognavigator die Option "Auswertung", wenn der MRM-Parser den Nachrichtenhauptteil gegen das von der Nachrichtengruppe generierte Wörterbuch prüfen soll. (Wenn eine Nachricht an das Fehlerterminal des Knotens übergeben wird, wird sie nicht ausgewertet.)

    Sie finden detaillierte Informationen hierzu unter Nachrichten prüfen und Eigenschaften der Gültigkeitsprüfung für Nachrichten in der MRM-Domäne.

  5. Wählen Sie im Eigenschaftendialognavigator 'Beschreibung' aus, um eine Kurzbeschreibung, eine ausführliche Beschreibung oder beides einzugeben.
  6. Klicken Sie auf Übernehmen, um die Änderungen am MQAntwortknoten vorzunehmen, ohne den Eigenschaftendialog zu schließen. Wählen Sie OK, um die Änderungen anzuwenden und den Eigenschaftendialog zu schließen.

    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.

Die Ausgabeterminals mit einem anderen Knoten verbinden

Schließen Sie das Ausgangs- oder Fehlerterminal dieses Knotens an einen anderen Knoten in diesem Nachrichtenfluss an, wenn Sie die Nachricht weiterverarbeiten, Fehler verarbeiten oder die Nachricht an eine weitere 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:

  • Name der Warteschlange
  • Name des Warteschlangenmanagers
  • Antwort-ID (diese hat den gleichen Wert wie Nachrichten-ID)
  • Nachrichten-ID (vom MQMD)
  • Korrelations-ID (vom MQMD)

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.

Für koordinierte Transaktionen konfigurieren

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:

  • Im Fall von Ja wird die Nachricht unter dem Synchronisationspunkt geschrieben (d. h. in einer WebSphere MQ-Arbeitseinheit).
  • Wenn Sie Automatisch (die Standardeinstellung) auswählen, wird die Nachricht unter dem Synchronisationspunkt geschrieben, wenn die eingehende Eingabenachricht als persistent markiert ist.
  • Im Fall von Nein wird die Nachricht nicht unter dem Synchronisationspunkt geschrieben.

Eine andere Eigenschaft des MQAntwortknotens - Persistenzmodus - bestimmt, ob die Ausgabenachricht als persistent markiert wird, wenn sie in die Ausgabewarteschlange eingereiht wird:

  • Im Fall von Ja wird die Nachricht als persistent markiert.
  • Bei Automatisch (die Standardeinstellung), wird die Nachrichtpersistenz durch die Eigenschaften der eingehenden Nachricht bestimmt, wie im MQMD (der WebSphere MQ-Nachrichtendeskriptor) festgelegt.
  • Im Fall von Nein wird die Nachricht nicht als persistent markiert.
  • Wenn Sie Wie für Warteschlange definiert wählen, wird die Nachrichtenpersistenz so festgelegt, wie in der WebSphere MQ-Warteschlange vom MQAntwortknoten definiert wurde, der die Option MQPER_PERSISTENCE_AS_Q_DEF im MQMD angibt.

Terminals und Eigenschaften

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 geleitet wird, wenn ein Fehler beim Einreihen der Nachricht in die Ausgabewarteschlange festgestellt 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 Kontrollkästchen 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 der 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 Kontrollkästchen) 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.
Bemerkungen | Marken | Downloads | Bibliothek | Unterstützung | Rückmeldung
Copyright IBM Corporation 1999, 2006 Letzte Aktualisierung: 18.05.2006
ac04580_