Dieses Kapitel enthält folgende Abschnitte:
Mit dem MQSendeknoten 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.
Der MQSendeknoten ü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.
Sie können die Warteschlange gegebenenfalls als eine WebSphere MQ-Clusterwarteschlange oder eine gemeinsam genutzte Warteschlange definieren. Wenn Sie eine WebSphere MQ-Clusterwarteschlange verwenden, lassen Sie den Namen des Warteschlangenmanagers leer.
Sie können den MQSendeknoten so konfigurieren, dass eine Nachricht in eine bestimmte WebSphere MQ-Warteschlange eingereiht wird, die in einem WS-Manager definiert ist, auf den der WS-Manager des Brokers zugreifen kann. Sie kann auch in die Zieladressen gestellt werden, die in der lokalen Umgebung (auch als 'Zieladressenliste' bezeichnet), die der Nachricht zugeordnet ist, angegeben sind.
Sie können andere Eigenschaften festlegen, um die Weise zu steuern, in der die Nachrichten gesendet werden. Hierfür müssen Sie die geeigneten MQPUT-Optionen festlegen. Sie können beispielsweise anfordern, dass eine Nachricht unter Transaktionssteuerung verarbeitet werden soll. 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 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, über das die Nachricht übergeben wird.
Wenn Ihr Nachrichtenfluss keine Nachrichten an eine WebSphere MQ-Warteschlange senden soll, können Sie einen anderen unterstützten Sendeknoten wählen.
Der MQSendeknoten wird in Workbench durch folgendes Symbol dargestellt:
Die nachfolgenden Beispiele erläutern die Verwendung dieses Knotens:
Stellen Sie sich als Beispiel für die Verwendung dieses Knotens vor, Sie haben eine Veröffentlichungsanwendung geschrieben, die in regelmäßigen Abständen Börsenaktualisierungen veröffentlicht. Die Anwendung sendet die Nachrichten an den Broker auf einem MQEmpfangsknoten, und der Nachrichtenfluss stellt mehreren Subskribenten die Veröffentlichungen über einen Veröffentlichungsknoten zur Verfügung. Sie konfigurieren einen Rechenknoten für die Erstellung einer neuen Ausgabenachricht, sobald sich der Kurs einer bestimmten Aktie ändert. Diese Informationen werden an einen MQSendeknoten übertragen, damit jede Kursänderung dieser Aktie festgehalten wird.
Wenn Sie eine Instanz des MQSendeknotens in einen Nachrichtenfluss eingereiht 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 grundlegenden 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 MQSendeknoten wie folgt:
Inaktivieren Sie das Markierungsfeld, wenn keine neue ID generiert werden soll. Beachten Sie, dass bei Aktivierung des Kontrollkästchens Anforderung in der Anforderungsanzeige des Eigenschaftendialogs weiterhin eine neue Nachrichten-ID generiert wird.
Das Handbuch WebSphere MQ Application Programming Reference enthält weitere Informationen zu den Optionen, denen diese Eigenschaft zugeordnet wird.
Das Handbuch WebSphere MQ Application Programming Reference enthält weitere Informationen zu den Optionen, denen diese Eigenschaft zugeordnet wird.
Das Handbuch WebSphere MQ Application Programming Reference enthält weitere Informationen zu den Optionen, denen diese Eigenschaft zugeordnet wird.
Das Handbuch WebSphere MQ Application Programming Reference enthält weitere Informationen zu den Optionen, denen diese Eigenschaften zugeordnet werden.
Beachten Sie, dass selbst bei Aktivierung des Kontrollkästchens Neue Nachrichten-ID in der Anzeige 'Erweitert' im Eigenschaftendialognavigator eine neue Nachrichten-ID generiert wird.
Sie finden detaillierte Informationen hierzu unter Nachrichten überprüfen und Eigenschaften der Gültigkeitsprüfung für Nachrichten in der MRM-Domäne.
Klicken Sie auf Abbrechen, um das Dialogfeld zu schließen und alle Änderungen zu verwerfen, die Sie an den Eigenschaften vorgenommen haben.
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.
Wenn Sie eines dieser Ausgabeterminals mit einem anderen Knoten im Nachrichtenfluss verbinden, 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:
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 die Aggregation in Ihren Nachrichtenflüssen verwenden, müssen Sie die Ausgangsterminals verwenden.
Bei der Festlegung eines MQSendeknotens definiert die Option, die Sie für die Eigenschaft Transaktionsmodus festlegen, ob die Nachricht unter Synchronisationspunktsteuerung geschrieben wird:
Eine weitere Eigenschaft des MQSendeknotens (Permanenzmodus) definiert, ob die Ausgabenachricht als permanent markiert wird, wenn sie in die Ausgabewarteschlange eingereiht wird:
In der nachfolgenden Tabelle werden die Terminals des MQSendeknotens 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 |
Ausgang | 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 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 MQSendeknotens beschrieben.
Eigenschaft | M | C | Standard | 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 nachfolgenden Tabelle werden die erweiterten Eigenschaften des MQSendeknotens beschrieben.
Eigenschaft | M | C | Standard | Beschreibung |
---|---|---|---|---|
Zielmodus | Ja | Nein | Name der Warteschlange | Die Warteschlangen, an die die Ausgabenachricht gesendet wird. Gültige Werte sind Zieladressenliste, Warteschlange für Antwortnachrichten und Warteschlangenname. |
Transaktionsmodus | Ja | Nein | Automatisch | Gibt an, ob die Nachricht transaktionsorientiert eingereiht wird. Gültige Werte sind Automatisch, Ja und Nein. |
Permanenzmodus | Ja | Nein | Automatisch | Gibt an, 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 | Gibt an, ob WebSphere MQ eine neue Nachrichten-ID generiert, die den Inhalt des Felds 'MsgId' im MQMD ersetzt. Wenn Sie das Markierungsfeld aktivieren, wird der Vorgang ausgeführt. |
Neue Korrelations-ID | Ja | Nein | Nicht ausgewählt | Gibt an, ob WebSphere MQ eine neue Korrelations-ID generiert, die den Inhalt des Felds 'CorrelId' im MQMD ersetzt. Wenn Sie das Markierungsfeld aktivieren, wird der Vorgang ausgeführt. |
Segmentierung zulässig | Ja | Nein | Nicht ausgewählt | WebSphere MQ teilt die Nachricht bei Bedarf im WS-Manager in verschiedene Segmente auf. Wenn Sie das Markierungsfeld aktivieren, wird der Vorgang ausgeführt. |
Nachrichtenkontext | Ja | Nein | Gesamten Kontext übergeben | Gibt an, wie der 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 | Gibt an, ob bei der Einreihung der Ausgabenachricht eine alternative Berechtigung verwendet wird. Wenn Sie das Markierungsfeld aktivieren, wird der Vorgang ausgeführt. |
In der nachfolgenden Tabelle werden die Anforderungseigenschaften des MQSendeknotens beschrieben.
Eigenschaft | M | C | Standard | Beschreibung |
---|---|---|---|---|
Anforderung | Ja | Nein | Nicht ausgewählt | Gibt an, ob jede Ausgabenachricht als Anforderungsnachricht generiert werden soll. Wenn Sie das Markierungsfeld aktivieren, wird der Vorgang ausgeführt. |
Ziel-WS-Manager für Antwortnachrichten | Nein | Ja | Der Name des WebSphere MQ-Warteschlangenmanagers, für den die in 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 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 | M | C | Standard | 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 Markierungsfeld) 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. |
In der nachfolgenden Tabelle werden die Beschreibungseigenschaften des MQSendeknotens beschrieben.
Eigenschaft | M | C | Standard | Beschreibung |
---|---|---|---|---|
Kurzbeschreibung | Nein | Nein | Kurze Beschreibung des Knotens | |
Ausführliche Beschreibung | Nein | Nein | Text, der den Zweck des Knotens im Nachrichtenfluss beschreibt |