Mit dem MQOutput-Knoten 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 MQOutput-Knoten ü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 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 WS-Managers leer.
Sie können den MQOutput-Knoten 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. .
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überhinaus 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 MQOutput-Knoten ist in der WebSphere MQ-Ablage der Palette enthalten und wird in der Workbench durch folgendes Symbol dargestellt:
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 fügen einen MQOutput-Knoten ein, um die Nachricht an eine Anwendung zu senden, die jede aufgetretene Kursänderung verzeichnet.
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. Klicken Sie zum Anzeigen der Eigenschaften des Knotens entweder doppelt auf den Knoten, oder klicken Sie mit der rechten Maustaste auf den Knoten und dann im Kontextmenü auf Eigenschaften.
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 MQOutput-Knoten wie folgt.
Bei
Auswahl dieser Option erzeugt der MQOutput-Knoten eine
WebSphere MQ-Antwortnachricht. Unter
Inhalt der WebSphere MQ-Antwortnachricht finden Sie weitere Informationen zu
den Einstellungen, die vom MQOutput-Knoten und vom
Root.MQMD-Ordner in dieser Situation verwendet werden.
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 oder im Version 5.3-Handbuch auf der Webseite der Bibliothek zu WebSphere MQ.
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 oder im Version 5.3-Handbuch auf der Webseite der Bibliothek zu WebSphere MQ.
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 oder im Version 5.3-Handbuch auf der Webseite der Bibliothek zu WebSphere MQ.
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 oder im Version 5.3-Handbuch auf der Webseite der Bibliothek zu WebSphere MQ.
Selbst wenn das Kontrollkästchen Neue Nachrichten-ID auf der Registerkarte Erweitert nicht aktiviert ist, wird eine neue Nachrichten-ID generiert.
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 die Nachricht an eine weitere Zieladresse zu senden.
MQMD.Report = 0; MQMD.PutApplType = MQAT_BROKER; MQMD.PutDate = aktuelle Zeitmarke MQMD.PutTime = aktuelle Zeitmarke MQMD.PutApplName = MsgTree.MQMD.ReplyToQMgr (erste 28 Zeichen)
MQMD.Version MQMD.Format MQMD.Priority MQMD.Persistence MQMD.Expiry MQMD.Encoding MQMD.CodedCharSetId MQMD.GroupId MQMD.MsgSeqNumber MQMD.Offset MQMD.MsgFlags MQMD.OriginalLength
IF MsgTree.MQMD.MsgType = MQMT_REQUEST THEN MQMD.MsgType = MQMT_REPLY; IF Nodes Message Context is Default, PassAll or PassIdentity THEN MQMD.UserIdentifer = MsgTree.MQMD.UserIdentifier; IF MsgTree.MQMD.Report contains MQRO_PASS_CORREL_ID THEN MQMD.CorrelId = MsgTree.MQMD.CorrelId; ELSE MQMD.CorrelId = MsgTree.MQMD.MsgId; IF MsgTree.MQMD.Report contains MQRO_PASS_MSG_ID THEN MQMD.MsgId = MsgTree.MQMD.MsgId; ELSE MQMD.MsgId = MQMI_NONE;
Wenn die MQMD-Ausgabestruktur aufgebaut wurde, wird der Nachrichtenkontext im MQOutput-Knoten ignoriert und das Verhalten ist wie bei Gesamten Kontext setzen.
Die Werte, die überschrieben werden, werden nur in der MQMD-Ausgabestruktur überschrieben; der MQMD-Ordner in der Nachrichtenbaumstruktur wird nicht aktualisiert.
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 O zeigt an, ob die Eigenschaft obligatorisch ist (markiert mit einem Sternchen, wenn ein Wert eingegeben werden muss, weil kein Standardwert definiert ist). Die Spalte K 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 | O | K | 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 | O | K | 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 (mit MQPUT) Nachrichten einreiht. |
In der folgenden Tabelle werden die erweiterten Eigenschaften des MQOutput-Knotens beschrieben.
Eigenschaft | O | K | Standardwert | Beschreibung |
---|---|---|---|---|
Zielmodus | Ja | Nein | Name der Warteschlange | Die Warteschlangen, an die die Ausgabenachricht gesendet wird. Gültige Werte sind , Warteschlange für Antwortnachrichten und Warteschlangenname. |
Transaktionsmodus | Ja | Nein | Automatisch | 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 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 | O | K | 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. |