Mit dem MQOutputknoten können Sie Nachrichten an Clients senden, die über WebSphere MQ Enterprise Transport eine Verbindung zum Broker herstellen und die MQI- und AMI-Anwendungsprogrammierschnittstellen verwenden.
Dieses Kapitel enthält folgende Abschnitte:
Der MQOutputknoten übergibt eine Ausgabenachricht aus einem Nachrichtenfluss an eine WebSphere MQ-Warteschlange. Der Knoten verwendet den MQPUT-Aufruf, um die Nachricht in der von Ihnen angegebenen Zielwarteschlange oder in den angegebenen Warteschlangen einzureihen.
Falls angebracht, definieren Sie die Warteschlange als WebSphere MQ-Clusterwarteschlange oder als gemeinsam genutzte Warteschlange. Wenn Sie eine WebSphere MQ-Clusterwarteschlange verwenden, lassen Sie den Namen des Warteschlangenmanagers leer.
Sie können den MQOutputknoten so konfigurieren, dass eine Nachricht in eine bestimmte WebSphere MQ-Warteschlange gestellt wird, die in einem WS-Manager, auf den der WS-Manager des Brokers zugreifen kann, definiert ist. Sie kann auch in die Zieladressen gestellt werden, die in der lokalen Umgebung (LocalEnvironment; auch als 'Zieladressenliste' bezeichnet), die der Nachricht zugeordnet ist, angegeben sind.
Legen Sie weitere Eigenschaften fest, um die Vorgehensweise beim Senden von Nachrichten zu steuern, indem geeignete MQPUT-Optionen angegeben werden; Sie können beispielsweise für eine Nachricht die Verarbeitung unter Transaktionssteuerung anfordern. Darüber hinaus können Sie angeben, dass WebSphere MQ die Nachricht im WS-Manager bei Bedarf in verschiedene Segmente teilen darf.
Wenn Sie einen Nachrichtenfluss erstellen, der als untergeordneter Nachrichtenfluss verwendet werden soll, können Sie keinen Standardsendeknoten verwenden. Verwenden Sie eine Instanz des Output-Knotens zum Erstellen eines Ausgangsterminals für den untergeordneten Nachrichtenfluss, durch den die Nachricht weitergegeben wird.
Wenn Ihr Nachrichtenfluss keine Nachrichten an eine WebSphere MQ-Warteschlange senden soll, wählen Sie einen anderen unterstützten Sendeknoten aus.
Der MQOutputknoten prüft, ob es in der Nachrichtenbaumstruktur einen MQMD-Header gibt. Ist dies nicht der Fall, erstellt der MQOutputknoten dort einen MQMD-Header und füllt ihn mit MQMD-Standardeigenschaften. Ist ein MQMD-Header vorhanden, prüft der MQOutputknoten, ob es sich um einen Header des Typs MQ handelt. Ist dies nicht der Fall, wird die Eigenschaft Nachrichtenkontext auf den Wert Standardwert gesetzt. Der MQOutputknoten behandelt alle anderen Transport-Header in der Nachrichtenbaumstruktur als Daten.
Der MQOutputknoten ist in der WebSphere MQ-Ablage der Palette enthalten und wird in der Workbench durch folgendes Symbol dargestellt:

Die folgenden Beispielprogramme verdeutlichen die Verwendung dieses Knotens:
Sie können Beispiele nur anzeigen, wenn Sie das Information Center verwenden, das im Message Broker Toolkit integriert ist.
Stellen Sie sich als Beispiel für die Verwendung dieses Knotens vor, Sie haben eine Veröffentlichungsanwendung geschrieben, die regelmäßige Bestandsaktualisierungen veröffentlicht. Die Anwendung sendet die Nachrichten an den Broker auf einem MQInput-Knoten, und der Nachrichtenfluss stellt mehreren Subskribenten die Veröffentlichungen über einen Publication-Knoten zur Verfügung. Sie konfigurieren einen Computeknoten für die Erstellung einer neuen Ausgabenachricht, sobald sich der Kurs einer bestimmten Aktie ändert. Diese Informationen werden an einen MQOutputknoten übertragen, damit jede Kursänderung dieser Aktie festgehalten wird.
Nachdem Sie eine Instanz des MQOutput-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.
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 MQOutputknoten wie folgt.
Inaktivieren Sie das Kontrollkästchen, wenn keine neue ID generiert werden soll. Es wird weiterhin eine neue Nachrichten-ID generiert, wenn Sie Anforderung auf der Registerkarte Anforderung auswählen.
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.
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.
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.
Weitere Informationen zu den Optionen, zu denen diese Eigenschaften eine Zuordnung durchführen, finden Sie im Abschnitt "Application Programming Reference" im WebSphere MQ Version 6 Information Center online.
Wenn dem Knoten ein Sicherheitsprofil zugeordnet und dieses Sicherheitsprofil für die Ausführung der Identitätsweitergabe konfiguriert ist, kann der ausgewählte Kontext außer Kraft gesetzt werden, um sicherzustellen, dass die ausgehende Identität gesetzt ist.
Selbst wenn das Kontrollkästchen Neue Nachrichten-ID auf der Registerkarte Erweitert nicht aktiviert ist, wird eine neue Nachrichten-ID generiert.
Sie finden detailliertere Informationen hierzu unter Nachrichten überprüfen und Auswertungseigenschaften.
Verbinden Sie das Eingangsterminal mit dem Knoten, von dem ausgehende Nachrichten weitergeleitet werden.
Schließen Sie das Ausgangs- 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.
Diese Werte werden in der Baumstruktur für die lokale Umgebung in die WrittenDestination-Unterverzeichnisstruktur geschrieben.
Wenn Sie kein Terminal anschließen, bleibt die LocalEnvironment-Verzeichnisstruktur unverändert.
Wenn Sie in Ihren Nachrichtenflüssen eine Aggregation verwenden, müssen Sie die Ausgabeterminals nutzen.
In der folgenden Tabelle werden die Terminals des MQOutput-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 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 MQOutput-Knotens beschrieben.
| Eigenschaft | M | C | Standardwert | Beschreibung |
|---|---|---|---|---|
| Knotenname | Nein | Nein | Knotentyp, z. B. MQOutput | 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 MQOutput-Knotens beschrieben.
| Eigenschaft | M | C | Standardwert | Beschreibung |
|---|---|---|---|---|
| Name des WS-Managers | Nein | Ja | Name des WebSphere MQ-Warteschlangenmanagers, für den die unter Name der Warteschlange angegebene Ausgabewarteschlange definiert ist | |
| Name der Warteschlange | Nein | Ja | Der Name der WebSphere MQ-Ausgabewarteschlange, in die dieser Knoten (unter Verwendung von MQPUT) Nachrichten einreiht. |
In der folgenden Tabelle werden die erweiterten Eigenschaften des MQOutput-Knotens beschrieben.
| Eigenschaft | M | C | Standardwert | Beschreibung |
|---|---|---|---|---|
| Zielmodus | Ja | Nein | Die Warteschlangen, an die die Ausgabenachricht gesendet wird. Gültige Werte sind Zieladressenliste, Warteschlange für Antwortnachrichten und Warteschlangenname. | |
| Transaktionsmodus | Ja | Nein | Name der Warteschlange | Durch diese Eigenschaft wird gesteuert, ob die Nachricht transaktionsorientiert eingereiht wird. Gültige Werte sind Automatisch, Ja und Nein. |
| 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. |
| Neue Nachrichten-ID | Ja | Nein | Nicht ausgewählt | Wenn Sie dieses Kontrollkästchen aktivieren, generiert WebSphere MQ eine neue Nachrichten-ID, die den Inhalt des Feldes 'MsgId' im MQMD ersetzt. |
| Neue Korrelations-ID | Ja | Nein | Nicht ausgewählt | Wenn Sie dieses Kontrollkästchen aktivieren, generiert WebSphere MQ eine neue Korrelations-ID, die den Inhalt des Feldes 'CorrelId' im MQMD ersetzt. |
| Segmentierung zulässig | Ja | Nein | Nicht ausgewählt | Wenn Sie dieses Kontrollkästchen aktivieren, teilt WebSphere MQ die Nachricht bei Bedarf im WS-Manager in verschiedene Segmente auf. |
| Nachrichtenkontext | Ja | Nein | Gesamten Kontext übergeben | Durch diese Eigenschaft wird gesteuert, wie Ursprungskontext gehandhabt wird. Gültige Werte sind Gesamten Kontext übergeben, ID übergeben, Gesamten Kontext setzen, ID setzen und Standardwert. |
| Alternative Benutzerberechtigung | Ja | Nein | Nicht ausgewählt | Wenn Sie dieses Kontrollkästchen aktivieren, wird beim Einreihen der Ausgabenachricht eine alternative Berechtigung verwendet. |
In der folgenden Tabelle werden die Anforderungseigenschaften des MQOutput-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 WebSphere MQ-Warteschlangenmanagers, für den die unter Warteschlange für Antwortnachrichten angegebene Ausgabewarteschlange definiert ist | |
| Warteschlange für Antwortnachrichten | Nein | Ja | Der Name der WebSphere MQ-Warteschlange, für die eine Antwort zu dieser Anforderung eingereiht wird. |
In der folgenden Tabelle werden die Auswertungseigenschaften des MQOutput-Knotens beschrieben.
Eine umfassende Beschreibung dieser Eigenschaften finden Sie unter Auswertungseigenschaften.
| Eigenschaft | M | C | 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. |