MQSendeknoten (MQOutput)

Dieses Kapitel enthält folgende Abschnitte:

Zweck

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:

Symbol für MQSendeknoten

Diesen Knoten in einem Nachrichtenfluss verwenden

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.

MQSendeknoten konfigurieren

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:

  1. Wenn Sie die Ausgabenachricht an eine einzelne Zielwarteschlange senden möchten, die über diesen Knoten definiert wird, geben Sie unter Name der Warteschlange den Namen der Warteschlange ein, an die der Nachrichtenfluss Nachrichten sendet. Geben Sie unter WS-Managername den Namen des Warteschlangenmanagers ein, für den diese Warteschlange definiert ist. Sie müssen diese Eigenschaften festlegen, wenn Sie die erweiterte Eigenschaft Zielmodus (siehe Beschreibung unten) auf Name der Warteschlange setzen. Wenn Sie den Zielmodus auf einen anderen Wert setzen, werden diese Eigenschaften ignoriert.
  2. Wählen Sie im Navigator des Eigenschaftendialogs 'Erweitert' aus. Mit diesen Eigenschaften werden die transaktionsorientierte Steuerung für die Nachricht und die Art der Einreihung der Nachricht in die Warteschlange definiert. Viele dieser Eigenschaften sind Optionen im MQPUT-Aufruf zugeordnet.
    • Wählen Sie in der Dropdown-Liste den Zielmodus aus. Diese Auswahl bestimmt die Warteschlangen, in die die Ausgabenachricht eingereiht wird.
      • Name der Warteschlange. Die Nachricht wird an die Warteschlange gesendet, die in der Eigenschaft Name der Warteschlange aufgeführt ist. Die Eigenschaften Name des WS-Managers und Name der Warteschlange (auf der Registerkarte Allgemein) müssen angegeben werden, wenn Sie diese Option wählen. Dies ist die Standardeinstellung.
      • Warteschlange für Antwortnachrichten. Die Nachricht wird an die im MQMD-Feld "ReplyToQ" aufgeführte Warteschlange gesendet.
      • Zieladressenliste. Die Nachricht wird an die Liste der in der LocalEnvironment-Baumstruktur (lokale Umgebung, auch bekannt als DestinationList) aufgeführten Warteschlangen gesendet, die mit dieser Nachricht verknüpft ist.
    • Wählen Sie in der Dropdown-Liste den Transaktionsmodus aus, um festzulegen, wie die Nachricht eingereiht werden soll.
      • Bei der Auswahl von Automatisch (dem Standardwert) wird die Transaktionalität der Nachricht davon abgeleitet, wie sie beim Empfangsknoten angegeben wurde.
      • Bei der Auswahl von Ja wird die Nachricht transaktionsorientiert eingereiht.
      • Bei der Auswahl von Nein wird die Nachricht nicht transaktionsorientiert eingereiht.
      Weitere Informationen finden Sie im Abschnitt Koordinierte Transaktionen konfigurieren.
    • Wählen Sie in der Dropdown-Liste den Permanenzmodus aus, um festzulegen, ob die Nachricht permanent eingereiht werden soll.
      • Bei der Auswahl von Automatisch (dem Standardwert) entspricht die Permanenz der Angabe in der ankommenden Nachricht.
      • Bei der Auswahl von Ja wird die Nachricht permanent eingereiht.
      • Bei der Auswahl von Nein wird die Nachricht nicht permanent eingereiht.
      • Bei der Auswahl von Wie für Warteschlange definiert entspricht die Nachrichtenpermanenz der Einstellung, die für die WebSphere MQ-Warteschlange definiert wurde.
    • Wählen Sie das Markierungsfeld Neue Nachrichten-ID aus, um für diese Nachricht eine neue Nachrichten-ID zu generieren. Diese Option wird der Option MQPMO_NEW_MSG_ID des MQPMO-Aufrufs der MQI-Schnittstelle zugeordnet.

      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.

    • Wählen Sie das Markierungsfeld Neue Korrelations-ID aus, um für diese Nachricht eine neue Korrelations-ID zu generieren. Diese Option wird der Option MQPMO_NEW_CORREL_ID des MQPMO-Aufrufs der MQI-Schnittstelle zugeordnet. Inaktivieren Sie das Markierungsfeld, wenn keine neue ID generiert werden soll.

      Das Handbuch WebSphere MQ Application Programming Reference enthält weitere Informationen zu den Optionen, denen diese Eigenschaft zugeordnet wird.

    • Wählen Sie das Markierungsfeld Segmentierung zulässig aus, wenn WebSphere MQ die Nachricht bei Bedarf im Warteschlangenmanager segmentieren soll. Damit eine Segmentierung stattfindet, müssen Sie auch den Wert MQMF_SEGMENTATION_ALLOWED im Feld 'MsgFlags' im MQMD festlegen. Inaktivieren Sie das Markierungsfeld, wenn keine Segmentierung erfolgen soll.

      Das Handbuch WebSphere MQ Application Programming Reference enthält weitere Informationen zu den Optionen, denen diese Eigenschaft zugeordnet wird.

    • Wählen Sie den Nachrichtenkontext aus, um anzugeben, wie der Ursprungskontext gehandhabt werden soll. Wählen Sie eine der folgenden Optionen aus:
      • Gesamten Kontext übergeben (wird der Option MQPMO_PASS_ALL_CONTEXT des MQPMO-Aufrufs der MQI-Schnittstelle zugeordnet.)
      • ID übergeben (wird der Option MQPMO_PASS_IDENTITY_CONTEXT des MQPMO-Aufrufs der MQI-Schnittstelle zugeordnet.)
      • Gesamten Kontext setzen (wird der Option MQPMO_SET_ALL_CONTEXT des MQPMO-Aufrufs der MQI-Schnittstelle zugeordnet.)
      • ID setzen (wird der Option MQPMO_SET_IDENTITY_CONTEXT des MQPMO-Aufrufs der MQI-Schnittstelle zugeordnet.)
      • Standardwert (wird der Option MQPMO_DEFAULT_CONTEXT des MQPMO-Aufrufs der MQI-Schnittstelle zugeordnet.)
      • Keinen (wird der Option MQPMO_NO_CONTEXT des MQPMO-Aufrufs der MQI-Schnittstelle zugeordnet.)

      Das Handbuch WebSphere MQ Application Programming Reference enthält weitere Informationen zu den Optionen, denen diese Eigenschaften zugeordnet werden.

    • Wählen Sie das Markierungsfeld Alternative Benutzerberechtigung aus, wenn in den Öffnungsoptionen (MQOO) der MQI-Schnittstelle die Option MQOO_ALTERNATE_USER_AUTHORITY festgelegt werden soll. Bei der Auswahl dieses Kästchens wird diese Option angegeben, wenn die Warteschlange zur Ausgabe geöffnet wird. Die alternativen Benutzerinformationen werden aus den Kontextinformationen in der Nachricht abgerufen. Inaktivieren Sie das Markierungsfeld, wenn Sie keine alternative Benutzerberechtigung angeben möchten. Wenn Sie das Kästchen inaktivieren, wird beim Einreihen der Nachricht die Benutzer-ID des Broker-Service verwendet.
  3. Wählen Sie im Navigator des Eigenschaftendialogs die Option 'Anforderung' aus, und legen Sie anschließend die Eigenschaften fest, die die Merkmale jeder generierten Ausgabenachricht definieren.
    • Wählen Sie das Kontrollkästchen Anforderung aus, um jede Ausgabenachricht im MQMD als Anforderungsnachricht (MQMT_REQUEST) zu markieren, und löschen Sie das Nachrichten-ID-Feld (Eintrag: MQMI_NONE), um sicherzustellen, dass WebSphere MQ eine neue ID generiert. Inaktivieren Sie das Markierungsfeld, um anzuzeigen, 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.

      Beachten Sie, dass selbst bei Aktivierung des Kontrollkästchens Neue Nachrichten-ID in der Anzeige 'Erweitert' im Eigenschaftendialognavigator eine neue Nachrichten-ID generiert wird.

    • Geben Sie in Ziel-WS-Manager für Antwortnachrichten einen Warteschlangenmanagernamen ein. Er wird in die MQMD-Struktur jeder Ausgabenachricht als Ziel-Warteschlangenmanager für Antwortnachrichten eingefügt.
    • Geben Sie in Warteschlange für Antwortnachrichten einen Warteschlangennamen ein. Er wird in die MQMD-Struktur jeder Ausgabenachricht als Warteschlange für Antwortnachrichten eingefügt.
  4. Wählen Sie im Eigenschaften-Dialognavigator die Option "Auswertung", wenn der MRM-Parser den Nachrichtenhauptteil gegen das von der Nachrichtengruppe generierte Wörterbuch prüfen soll. (Wenn eine Nachricht an das Fehlerterminal des Knotens übergeben wird, wird sie nicht ausgewertet.)

    Sie finden detaillierte Informationen hierzu unter Nachrichten überprüfen und Eigenschaften der Gültigkeitsprüfung für Nachrichten in der MRM-Domäne.

  5. Wählen Sie im Eigenschaften-Dialognavigator die Option "Beschreibung", um ein kurze und/oder ausführliche Beschreibung einzugeben.
  6. Klicken Sie auf Übernehmen, um die Änderungen am MQSendeknoten vorzunehmen, ohne das Dialogfeld mit den Eigenschaften zu schließen. Klicken Sie auf OK, um die Änderungen zu übernehmen und das Dialogfeld mit den Eigenschaften zu schließen.

    Klicken Sie auf Abbrechen, um das Dialogfeld zu schließen und alle Änderungen zu verwerfen, die Sie an den Eigenschaften vorgenommen haben.

Verbindungen zu Terminals herstellen

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:

  • 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 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.

Koordinierte Transaktionen konfigurieren

Bei der Festlegung eines MQSendeknotens definiert die Option, die Sie für die Eigenschaft Transaktionsmodus festlegen, ob die Nachricht unter Synchronisationspunktsteuerung geschrieben wird:

  • Bei der Angabe von Ja wird die Nachricht unter Synchronisationspunktsteuerung geschrieben (d. h. innerhalb einer WebSphere MQ-Arbeitseinheit).
  • Bei der Auswahl von Automatisch (dem Standardwert) wird die Nachricht unter Synchronisationspunktsteuerung geschrieben, wenn die ankommende Eingabenachricht als 'permanent' markiert ist.
  • Bei der Angabe von Nein wird die Nachricht nicht unter Synchronisationspunktsteuerung geschrieben.

Eine weitere Eigenschaft des MQSendeknotens (Permanenzmodus) definiert, ob die Ausgabenachricht als permanent markiert wird, wenn sie in die Ausgabewarteschlange eingereiht wird:

  • Bei der Angabe von Ja wird die Nachricht als permanent markiert.
  • Bei der Angabe von Automatisch (dem Standardwert) richtet sich die Nachrichtenpermanenz nach den Eigenschaften der ankommenden Nachricht, die im MQMD (dem WebSphere MQ-Nachrichtendeskriptor) festgelegt sind.
  • Bei der Angabe von Nein wird die Nachricht nicht als permanent markiert.
  • Bei der Auswahl von Wie für Warteschlange definiert entspricht die Nachrichtenpermanenz der Einstellung, die vom MQSendeknoten durch die Angabe der Option MQPER_PERSISTENCE_AS_Q_DEF im MQMD für die WebSphere MQ-Warteschlange definiert wurde.

Terminals und Eigenschaften

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
Bemerkungen | Marken | Downloads | Bibliothek | Unterstützung | Rückmeldung
Copyright IBM Corporation 1999, 2006 Letzte Aktualisierung: 23. Aug. 2006
ac04570_