MQeSendeknoten (MQeOutput)

Achtung: Die Verwendung von Nachrichtenflüssen mit MQeEmpfangs- und MQeSendeknoten wird in WebSphere Message Broker Version 6.0 nicht weiter unterstützt. Das hier beschriebene Verhalten ist nur für die Implementierung von Version 6.0 in eine frühere Version und zur Bereitstellung einer Route für die Migration vorgesehen. Überarbeiten Sie Ihre Nachrichtenflüsse, um die MQe-Knoten zu entfernen und sie durch MQ-Knoten zu ersetzen, die für Ihre Spezifikationen konfiguriert und für die Konfiguration Ihres MQe-Gateways koordiniert wurden. Weiter Informationen finden Sie unter Nachrichtenfluss mit WebSphere MQ Everyplace-Knoten migrieren.

Dieses Kapitel enthält folgende Abschnitte:

Zweck

Mit dem MQe-Sendeknoten senden Sie Nachrichten an Clients, die unter Verwendung des WebSphere MQ Mobile Transport-Protokolls mit dem Broker verbunden sind.

Der MQeSendeknoten leitet Nachrichten an Warteschlangenmanager von WebSphere MQ Everyplace weiter. Wenn Sie einen nicht-lokalen Ziel-Warteschlangenmanager angeben, müssen Sie sicher stellen, dass es entweder eine Route zum Warteschlangenmanager gibt oder dass die Warteschlange des Warteschlangenmanagers, falls vorhanden, gespeichert und weitergeleitet wird.

Sie können mit dem MQeSendeknoten nicht die Transaktionsmerkmale des Nachrichtenflusses ändern. Die vom Empfangsknoten des Nachrichtenflusses festgelegten Transaktionsmerkmale bestimmen das transaktionale Verhalten des Nachrichtenflusses.

Sie können keine MQeSendeknoten in Nachrichtenflüssen verwenden, die Sie in z/OS-Systemen einsetzen.

Wenn Sie einen Nachrichtenfluss erstellen, der als untergeordneter Fluss verwendet werden soll, können Sie keinen Standardsendeknoten verwenden. Sie müssen mit einer Instanz des Sendeknotens ein Ausgangsterminal für den untergeordneten Fluss erstellen, um die Nachricht zu verbreiten.

Wenn Ihr Nachrichtenfluss keine Nachrichten an eine WebSphere MQ Everyplace-Warteschlange senden soll, können Sie einen anderen unterstützten Sendeknoten wählen.

Der MQeSendeknoten wird in Workbench durch folgendes Symbol dargestellt:

Symbol für MQeSendeknoten

Diesen Knoten in einem Nachrichtenfluss verwenden

Stellen Sie sich als Beispiel für die Verwendung dieses Knotens einen Landwirt vor, der seine Felder kontrolliert, um deren Bewässerung zu prüfen. Bei dieser Arbeit verwendet er einen PDA, auf dem WebSphere MQ Everyplace installiert ist. Er stellt fest, dass seine Felder nicht bewässert werden, und überprüft mit Hilfe von PDA und einem globalen Satellitennavigationslink das Bewässerungsventil. Dabei bemerkt er, dass das Ventil defekt ist. Diese Information ist verfügbar, da das SCADA-Ferngerät, mit dem das Ventil gesteuert wird, eine Diagnosenachricht veröffentlicht hat. Diese Nachricht wurde vom Broker abgerufen, an einen MQeSendeknoten und dann an den WebSphere MQ Everyplace-Client auf dem PDA weitergeleitet.

Dokumentation zu WebSphere MQ Everyplace

Weitere Informationen zu WebSphere MQ Everyplace und den Eigenschaften des Knotens finden Sie in der Dokumentation zu WebSphere MQ Everyplace unter Webseite von WebSphere MQ.

MQeSendeknoten konfigurieren

Wenn Sie eine Instanz des MQeSendeknotens in einen Nachrichtenfluss gestellt haben, können Sie ihn konfigurieren. Klicken Sie mit der rechten Maustaste in der Editoransicht auf den Knoten, und wählen Sie die Option Eigenschaften aus. Daraufhin werden die allgemeinen Eigenschaften des Knotens angezeigt.

Alle verbindlichen Eigenschaften, für die Sie einen Wert eingeben müssen (d. h. Eigenschaften ohne definierten Standardwert) sind dort mit einem Sternchen gekennzeichnet.

Konfigurieren Sie den MQeSendeknoten wie folgt:

  1. Geben Sie den Namen des WS-Managers und den Namen der Warteschlange ein, die die Zieladresse für die Ausgabenachricht angeben, wenn Sie unter Zielmodus (siehe nachfolgende Beschreibung) die Option Name der Warteschlange auswählen. Falls Sie eine andere Option für den Zielmodus auswählen, müssen diese Eigenschaften nicht konfiguriert werden.
  2. Wählen Sie im Eigenschaften-Dialognavigator die Option Erweitert, und wählen Sie dann aus der Dropdown-Liste die Option Zielmodus. Sie bestimmt die Warteschlange, an die die Ausgabenachricht gesendet werden soll.
    • Name der Warteschlange. Die Nachricht wird an die Warteschlange gesendet, die in der Eigenschaft Name der Warteschlange aufgeführt ist. Die Eigenschaften Name des WS-Managers und Name der Warteschlange (auf der Registerkarte Allgemein) müssen angegeben werden, wenn Sie diese Option wählen. Dies ist die Standardeinstellung.
    • Warteschlange für Antwortnachrichten. Die Nachricht wird an die im MQMD-Feld "ReplyToQ" aufgeführte Warteschlange gesendet.
    • Zieladressenliste. Die Nachricht wird an die Liste der in der LocalEnvironment-Baumstruktur (lokale Umgebung, auch bekannt als DestinationList) aufgeführten Warteschlangen gesendet, die mit dieser Nachricht verknüpft ist.
  3. Wählen Sie im Eigenschaften-Dialognavigator die Option "Anforderung" aus, und legen Sie anschließend die Eigenschaften fest, die die Merkmale jeder generierten Ausgabenachricht definieren.
    1. Aktivieren Sie das Markierungsfeld Anforderung, um anzuzeigen, dass jede Ausgabenachricht in MQMD als Anforderungsnachricht (MQMD_REQUEST) markiert wird, und löschen Sie das Nachrichten-ID-Feld (Eintrag: MQMI_NONE), damit WebSphere MQ eine neue ID generiert. Inaktivieren Sie das Markierungsfeld, um anzuzeigen, dass keine Ausgabenachricht als Anforderungsnachricht markiert wird. Sie können dieses Markierungsfeld nicht aktivieren, wenn Sie als Zielmodus die Option Warteschlange für Antwortnachrichten angegeben haben.
    2. Geben Sie den Namen des WebSphere MQ Everyplace-Warteschlangenmanagers unter Ziel-WS-Manager für Antwortnachrichten ein. Er wird in die MQMD-Struktur jeder Ausgabenachricht als Ziel-Warteschlangenmanager für Antwortnachrichten eingefügt. Dieser neue Wert überschreibt den aktuellen Wert in der MQMD-Struktur.
    3. Geben Sie den Namen des WebSphere MQ Everyplace-Warteschlangenmanagers unter Warteschlange für Antwortnachrichten ein. Er wird in die MQMD-Struktur jeder Ausgabenachricht als Warteschlange für Antwortnachrichten eingefügt. Dieser neue Wert überschreibt den aktuellen Wert in der MQMD-Struktur.
  4. Wählen Sie im Eigenschaften-Dialognavigator die Option "Beschreibung", um ein kurze und/oder ausführliche Beschreibung einzugeben.
  5. Klicken Sie auf Übernehmen, um die Änderungen am MQeSendeknoten vorzunehmen, ohne das Dialogfeld mit den Eigenschaften zu schließen. Klicken Sie auf OK, um die Änderungen zu übernehmen und das Dialogfeld mit den Eigenschaften zu schließen.

    Klicken Sie auf Abbrechen, um das Dialogfeld zu schließen und alle Änderungen zu verwerfen, die Sie an den Eigenschaften vorgenommen haben.

Verbindungen zu Terminals herstellen

Verbinden Sie das Eingangsterminal mit dem Knoten, von dem abgehende Nachrichten weitergeleitet werden.

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.

In diesen Fällen wird die mit der Nachricht verknüpfte lokale Umgebung mit folgenden Informationen zu jeder Zieladresse ergänzt, an die die Nachricht von diesem Knoten gesendet wurde:

  • Warteschlangenname
  • Name des Warteschlangenmanagers
  • Nachrichtenantwort-ID (identisch mit dem Wert der Nachrichten-ID)
  • Nachrichten-ID (von der MQMD-Struktur)
  • Korrelations-ID (von der MQMD-Struktur)

Diese Werte werden in der LocalEnvironment-Baumstruktur in die WrittenDestination-Unterverzeichnisstruktur geschrieben.

Wenn Sie kein Terminal anschließen, bleibt die LocalEnvironment-Verzeichnisstruktur unverändert.

Wenn Sie in Ihren Nachrichtenflüssen aggregieren, müssen Sie diese Terminals verwenden.

Terminals und Eigenschaften

In der nachfolgenden Tabelle werden die MQeSendeknotenterminals 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
Ausgangsterminal Das Ausgabeterminal, an das die Nachricht geleitet wird, wenn sie erfolgreich in die Ausgabewarteschlange eingereiht wurde und falls in diesem Nachrichtenfluss eine weitere Verarbeitung erforderlich ist

In der nachfolgenden Tabelle werden die Knoteneigenschaften beschrieben. Die Spalte M zeigt an, ob die Eigenschaft obligatorisch ist (markiert mit einem Sternchen im Eigenschaftendialog, ob Sie einen Wert eingeben müssen, wenn kein Standardwert definiert ist). Die Spalte C zeigt an, ob die Eigenschaft konfigurierbar ist (Sie können den Wert ändern, wenn Sie der BAR-Datei den Nachrichtenfluss hinzufügen, um ihn einzusetzen).

In der nachfolgenden Tabelle werden die grundlegenden Eigenschaften des MQeSendeknotens beschrieben.

Eigenschaft M C Standardwert Beschreibung
Name des WS-Managers Nein Ja   Name des WebSphere MQ Everyplace-Warteschlangenmanagers, für den die unter Name der Warteschlange angegebene Ausgabewarteschlange definiert ist
Name der Warteschlange Nein Ja   Name der WebSphere MQ Everyplace-Ausgabewarteschlange, in die dieser Knoten Nachrichten stellt

In der nachfolgenden Tabelle werden die erweiterten Eigenschaften des MQeSendeknotens beschrieben.

Eigenschaft M C Standardwert Beschreibung
Zielmodus Ja Nein Zieladressenliste Die Warteschlangen, an die die Ausgabenachricht gesendet wird. Gültige Werte sind Name der Warteschlange, Warteschlange für Antwortnachrichten und Zieladressenliste.

In der nachfolgenden Tabelle werden die Anforderungseigenschaften des MQeSendeknotens beschrieben.

Eigenschaft M C Standardwert Beschreibung
Request (Anforderung) Ja Nein Nicht ausgewählt Ob alle Ausgabenachrichten als Anforderungsnachricht generiert werden. Wenn Sie das Markierungsfeld aktivieren, wird der Vorgang ausgeführt.
Ziel-WS-Manager für Antwortnachrichten Nein Ja   Name des Warteschlangenmanagers, für den die unter Warteschlange für Antwortnachrichten angegebene Ausgabewarteschlange definiert ist
Warteschlange für Antwortnachrichten Nein Ja   Name der Warteschlange für Antwortnachrichten, in die die Antwort auf diese Anforderung gestellt wird

In der nachfolgenden Tabelle werden die Beschreibungseigenschaften des MQeSendeknotens beschrieben.

Eigenschaft M C Standardwert Beschreibung
Kurzbeschreibung Nein Nein   Kurze Beschreibung des Knotens
Ausführliche Beschreibung Nein Nein   Text, der den Zweck des Knotens im Nachrichtenfluss beschreibt
Bemerkungen | Marken | Downloads | Bibliothek | Unterstützung | Rückmeldung
Copyright IBM Corporation 1999, 2006 Letzte Aktualisierung: 23. Aug. 2006
ac04610_