MQeOutput-Knoten

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

Achtung: Die Verwendung von Nachrichtenflüssen mit MQeEmpfangs- und MQeSendeknoten wird in Version 6.1 nicht weiter unterstützt. Das hier beschriebene Verhalten ist nur für die Implementierung von Version 6.1 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

Der MQeOutput-Knoten leitet Nachrichten an Warteschlangenmanager von WebSphere MQ Everyplace weiter. Wenn Sie einen nicht-lokalen Ziel-Warteschlangenmanager angeben, müssen Sie sicherstellen, 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 MQeOutput-Knoten nicht die Transaktionsmerkmale des Nachrichtenflusses ändern. Die vom Empfangsknoten des Nachrichtenflusses festgelegten Transaktionsmerkmale bestimmen das transaktionale Verhalten des Nachrichtenflusses.

z/OS platform Sie können keine MQeOutput-Knoten in Nachrichtenflüssen verwenden, die Sie auf 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 Outputknotens ein Ausgabeterminal für den untergeordneten Fluss erstellen, über das die Nachricht übergeben wird.

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

Der MQeOutputknoten ist in der WebSphere MQ-Ablage der Palette enthalten und wird in der 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 und an einen MQeOutput-Knoten 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.

Den MQeOutputknoten konfigurieren

Nachdem Sie eine Instanz des MQeOutputknotens in einen Nachrichtenfluss eingereiht haben, können Sie den Knoten konfigurieren; siehe Nachrichtenflussknoten konfigurieren. Die Knoteneigenschaften werden in der Eigenschaftenansicht angezeigt.

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

Konfigurieren Sie den MQeOutput-Knoten folgendermaßen:

  1. Optional: Geben Sie auf der Registerkarte Beschreibung eine Kurzbeschreibung, eine Ausführliche Beschreibung oder beides ein. Sie können den Knoten dort auch umbenennen.
  2. Geben Sie auf der Registerkarte Grundeinstellungen den Namen des WS-Managers und den Namen der Warteschlange ein, die die Zieladresse für die Ausgabenachricht angeben, wenn Sie unter Zielmodus (auf der Registerkarte Erweitert) 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.
  3. Wählen Sie auf der Registerkarte Erweitert die Eigenschaft Zielmodus aus der Liste aus (über diese Eigenschaft werden die Warteschlangen festgelegt, an welche die Ausgabenachrichten zugestellt werden sollen):
    • Name der Warteschlange. Die Nachricht wird an die Warteschlange gesendet, die in der Eigenschaft Name der Warteschlange angegeben ist. Wenn Sie diese Option wählen, müssen die Eigenschaften Name des WS-Managers und Name der Warteschlange (auf der Registerkarte Grundeinstellung) angegeben werden.
    • Warteschlange für Antwortnachrichten. Die Nachricht wird an die im MQMD-Feld 'ReplyToQ' genannte Warteschlange gesendet.
    • Zieladressenliste (Standardwert). Die Nachricht wird an die Liste der Warteschlangen gesendet, die in der lokalen Umgebung (LocalEnvironment; auch als 'Zieladressenliste' bekannt), die mit dieser Nachricht verknüpft ist, genannt werden.
  4. Legen Sie auf der Registerkarte Anforderung die Eigenschaften zur Definition der Merkmale jeder generierten Ausgabenachricht fest.
    1. Aktivieren Sie Anforderung, um anzugeben, 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 Kontrollkästchen, um anzugeben, 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. Dieser Name wird in die MQMD-Struktur jeder Ausgabenachricht als Manager der Warteschlange 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. Dieser Name 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.

Verbindungen zu Terminals herstellen

Verbinden Sie das Eingangsterminal mit dem Knoten, von dem ausgehende Nachrichten weitergeleitet 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 die Nachricht weitergegeben wird, wird die mit der Nachricht verknüpfte lokale Umgebung (LocalEnvironment) 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 den Ordner 'WrittenDestination' der lokalen Umgebung 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 folgenden Tabelle werden die MQeOutput-Knotenterminals 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 eingereiht wurde und falls in diesem Nachrichtenfluss eine weitere Verarbeitung erforderlich ist

In den folgenden Tabellen werden die Knoteneigenschaften beschrieben. Die Spalte M zeigt an, ob die Eigenschaft obligatorisch ist (markiert mit einem Sternchen, wenn ein Wert eingegeben werden muss, weil kein Standardwert definiert ist). Die Spalte C 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 MQeOutput-Knotens beschrieben.

Eigenschaft M C Standardwert Beschreibung
Knotenname Nein Nein Knotentyp, z. B. MQeOutput Der Name des Knotens.
Kurzbeschreibung Nein Nein   Kurze Beschreibung des Knotens
Ausführliche Beschreibung Nein Nein   Text, der den Zweck des Knotens im Nachrichtenfluss beschreibt

In der folgenden Tabelle werden die grundlegenden Eigenschaften des MQeOutput-Knotens beschrieben.

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

In der nachfolgenden Tabelle werden die erweiterten Eigenschaften des MQeOutput-Knotens 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 folgenden Tabelle werden die Anforderungseigenschaften des MQeOutput-Knotens beschrieben.

Eigenschaft M C Standardwert Beschreibung
Anforderung Ja Nein Nicht ausgewählt Wenn Sie das Kontrollkästchen aktivieren, wird jede Ausgabenachricht als Anforderungsnachricht generiert.
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
Bemerkungen | Marken | Downloads | Bibliothek | Unterstützung | Rückmeldung
Copyright IBM Corporation 1999, 2007 Letzte Aktualisierung: Jan 24, 2008
ac04610_