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 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 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:
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 fügen einen MQSendeknoten ein, um die Nachricht an eine Anwendung zu senden, die jede aufgetretene Kursänderung verzeichnet.
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.
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 die Nachricht an eine weitere Zieladresse senden möchten.
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 , 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 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 |