MQSendeknoten

Dieses Thema ist in folgende Abschnitte eingeteilt:

Zweck

Nutzen Sie den MQSendeknoten, um Nachrichten an Clients zu senden, die mit Hilfe von WebSphere MQ Enterprise Transport eine Verbindung zum Broker aufbauen und welche die MQI- und AMI-Anwendungsprogrammierschnittstelle verwenden.

Der MQSendeknoten stellt eine Ausgabenachricht eines Nachrichtenflusses an eine WebSphere MQ-Warteschlange zu. Der Knoten verwendet MQPUT, um die Nachricht in die Zielwarteschlange einzureihen.

Falls passend, können Sie die Warteschlange als eine WebSphere MQ-Clusterwarteschlange oder als gemeinsam genutzte Warteschlange definieren. Lassen Sie bei der Verwendung einer WebSphere MQ-Clusterwarteschlange den Namen des Warteschlangenmanagers frei.

Sie können den MQSendeknoten so konfigurieren, dass er eine Nachricht in eine bestimmte WebSphere MQ-Warteschlange einreiht, die bei einem Warteschlangenmanager definiert ist, der dem Warteschlangenmanager des Brokers zugänglich ist.

Sie können andere Eigenschaften angeben, um die Sendeart der Nachrichten zu bestimmen; hierzu müssen die entsprechenden MQPUT-Optionen festgelegt sein. Beispiel: Sie können anfordern, dass eine Nachricht unter Transaktionssteuerung verarbeitet wird. Zudem können Sie angeben, dass WebSphere MQ - falls angemessen - die Nachricht im Warteschlangenmanager in Segmente unterteilt.

Wenn Sie einen Nachrichtenfluss so erstellen, dass er einen untergeordneten Fluss verwendet, können Sie keinen Standardsendeknoten benutzen, sondern müssen eine Instanz des Sendeknotens verwenden, um ein Ausgangsterminal für den untergeordneten Fluss zu 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 der Workbench durch das folgende Symbol dargestellt:

Symbol für MQSendeknoten

Verwendung dieses Knotens in einem Nachrichtenfluss

Verwendungsbeispiel für diesen Knoten: Angenommen, Sie haben eine Veröffentlichungsanwendung geschrieben, die regelmäßig Bestandsaktualisierungen veröffentlicht. Die Anwendung sendet die Nachrichten an den Broker auf einem MQEmpfangsknoten, und der Nachrichtenfluss macht die Veröffentlichungen über einen Veröffentlichungsknoten für mehrere Subskribenten verfügbar. Sie schließen einen MQSendeknoten ein, der die Nachricht an eine Anwendung sendet, die jede auftretende Preisänderung aufzeichnet.

Den MQSendeknoten konfigurieren

Wenn Sie eine Instanz des MQSendeknotens in einen Nachrichtenfluss eingereiht haben, können Sie sie konfigurieren. Klicken Sie in der Editoransicht mit der rechten Maustaste auf den Knoten, und wählen Sie dann Eigenschaften. Es werden die Grundeigenschaften des Knotens angezeigt.

Alle verbindlichen Eigenschaften, für die Sie einen Wert eingeben müssen (diejenigen, für die kein Standardwert definiert ist), sind im Eigenschaftendialog mit einem Stern markiert.

Konfigurieren Sie den MQSendeknoten wie folgt:

  1. Wenn Sie die Ausgabenachricht an eine einzelne Zielwarteschlange senden möchten, die von diesem Knoten definiert wird, geben Sie den Namen der Warteschlange ein, an die der Nachrichtenfluss Nachrichten in Warteschlangenname sendet. Geben Sie den Namen des Warteschlangenmanagers ein, zu dem diese Warteschlange in Name des Warteschlangenmanagers definiert ist. Sie müssen diese Eigenschaften angeben, wenn Sie die erweiterte Eigenschaft Zielmodus (Beschreibung unten) auf Warteschlangenname einstellen. Wenn Sie Zielmodus auf einen anderen Wert eingestellt haben, werden diese Eigenschaften ignoriert.
  2. Wählen Sie im Eigenschaftendialognavigator 'Erweitert' aus. Diese Eigenschaften definieren die transaktionsorientierte Steuerung für die Nachricht und die Art, wie die Nachricht in die Warteschlange eingereiht wird. Viele dieser Eigenschaften weisen eine Zuordnung zu Optionen beim MQPUT-Aufruf auf.
    • Wählen Sie in der Dropdown-Liste den Zielmodus aus. Somit werden die Warteschlangen identifiziert, in welche die Ausgabenachricht eingereiht wird.
      • Warteschlangenname. Die Nachricht wird an die Warteschlange gesendet, die in der Eigenschaft Warteschlangenname benannt wird. Die Eigenschaften Name des WS-Managers und Warteschlangenname (auf der Registerkarte 'Grundeinstellung') sind obligatorisch, wenn Sie diese Option auswählen. Dies ist die Standardeinstellung.
      • Warteschlange für Antwortnachrichten. Die Nachricht wird an die Warteschlange gesendet, die im Feld 'ReplyToQ' benannt wird.
    • Wählen Sie in der Dropdown-Liste den Transaktionsmodus aus, um zu bestimmen, wie die Nachricht eingereiht wird.
      • Wenn Sie Automatisch (die Standardeinstellung) auswählen, wird die Transaktionsorientierung der Nachricht von der Art abgeleitet, in der sie beim Empfangsknoten angegeben wurde.
      • Wählen Sie Ja aus, wird die Nachricht transaktionsorientiert eingereiht.
      • Wählen Sie Nein aus, wird die Nachricht nicht transaktionsorientiert eingereiht.
      Weitere Informationen hierzu finden Sie unter Für koordinierte Transaktionen konfigurieren.
    • Wählen Sie in der Dropdown-Liste den Persistenzmodus aus, um zu bestimmen, ob die Nachricht persistent eingereiht wird.
      • Wenn Sie Automatisch (die Standardeinstellung) auswählen, ist die Persistenz so, wie sie in der eingehenden Nachricht angegeben ist.
      • Wählen Sie Ja aus, wird die Nachricht persistent eingereiht.
      • Wählen Sie Nein aus, wird die Nachricht nicht persistent eingereiht.
      • Wenn Sie Wie für Warteschlange definiert wählen, wird die Nachrichtenpersistenz so festgelegt, wie für die WebSphere MQ-Warteschlange definiert wurde.
    • Wählen Sie das Kontrollkästchen Neue Nachrichten-ID aus, um eine neue Nachrichten-ID für diese Nachricht zu generieren. Dies führt zur Zuordnung zur Option MQPMO_NEW_MSG_ID der MQPMO der MQI.

      Entfernen Sie das Häkchen aus dem Kontrollkästchen, 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.

      Weitere Informationen zu den Optionen, zu denen diese Eigenschaft eine Zuordnung durchführt, finden Sie im Handbuch WebSphere MQ Application Programming Reference.

    • Wählen Sie das das Kontrollkästchen Neue Korrelations-ID aus, um eine neue Korrelations-ID für diese Nachricht zu generieren. Dies führt zu einer Zuordnung zur Option MQPMO_NEW_CORREL_ID der MQPMO der MQI. Entfernen Sie das Häkchen aus dem Kontrollkästchen, wenn keine neue ID generiert werden soll.

      Weitere Informationen zu den Optionen, zu denen diese Eigenschaft eine Zuordnung durchführt, finden Sie im Handbuch WebSphere MQ Application Programming Reference.

    • Wählen Sie das Kontrollkästchen Segmentierung zulässig aus, wenn WebSphere MQ die Nachricht im Warteschlangenmanager segmentieren soll, falls angebracht. Sie müssen MQMF_SEGMENTATION_ALLOWED im MsgFlags-Feld im MQMD festlegen, damit die Segmentierung durchgeführt wird. Entfernen Sie das Häkchen aus dem Kontrollkästchen, wenn keine Segmentierung erwünscht ist.

      Weitere Informationen zu den Optionen, zu denen diese Eigenschaft eine Zuordnung durchführt, finden Sie im Handbuch WebSphere MQ Application Programming Reference.

    • Wählen Sie den Nachrichtenkontext aus, um anzugeben, wie der Ursprungskontext gehandhabt werden soll. Wählen Sie eine der folgenden Optionen:
      • Gesamten Kontext übergeben (Zuordnen zur Option MQPMO_PASS_ALL_CONTEXT der MQPMO der MQI).
      • ID übergeben (Zuordnen zur Option MQPMO_PASS_IDENTITY_CONTEXT der MQPMO der MQI).
      • Gesamten Kontext setzen (Zuordnen zur Option MQPMO_SET_ALL_CONTEXT der MQPMO der MQI).
      • ID setzen (Zuordnen zur Option MQPMO_SET_IDENTITY_CONTEXT der MQPMO der MQI).
      • Standardwert (Zuordnung zur Option MQPMO_DEFAULT_CONTEXT der MQPMO der MQI).
      • Keine (Zuordnung zur Option MQPMO_NO_CONTEXT der MQPMO der MQI).

      Weitere Informationen zu den Optionen, zu denen diese Eigenschaften eine Zuordnung durchführen, finden Sie im Handbuch WebSphere MQ Application Programming Reference.

    • Wählen Sie das Kontrollkästchen Alternative Benutzerberechtigung aus, wenn die Option MQOO_ALTERNATE_USER_AUTHORITY bei den Öffnungsoptionen (MQOO) der MQI eingestellt werden soll. Wenn Sie dieses Kontrollkästchen auswählen, wird diese Option angegeben, wenn die Warteschlange für die Ausgabe geöffnet wird. Die Informationen des alternativen Benutzers werden von den Kontextinformationen in der Nachricht abgerufen. Entfernen Sie das Häkchen aus dem Kontrollkästchen, wenn wenn Sie keine alternative Benutzerberechtigung angeben möchten. Wenn Sie das Häkchen entfernen, wird die Benutzer-ID des Broker-Service beim Einreihen der Nachricht verwendet.
  3. Wählen Sie im Eigenschaftendialognavigator 'Anforderung' aus, und geben Sie die Eigenschaften an, um die Merkmale von jeder generierten Ausgabenachricht zu 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. Heben Sie die Auswahl des Kontrollkästchens auf, um anzugeben, dass jede Ausgabenachricht nicht als Anforderungsnachricht markiert ist. Dieses Kontrollkästchen kann nicht ausgewählt werden, wenn Sie einen Zielmodus von Warteschlange für Antwortnachrichten ausgewählt 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. Dieser wird in den MQMD von jeder Ausgabenachricht als Ziel-WS-Manager für Antwortnachrichten eingefügt.
    • Geben Sie in Warteschlange für Antwortnachrichten einen Warteschlangennamen ein. Dieser wird in den MQMD von jeder Ausgabenachricht als Warteschlange für Antwortnachrichten eingefügt.
  4. Wählen Sie im Eigenschaftendialognavigator 'Beschreibung' aus, um eine Kurzbeschreibung, eine ausführliche Beschreibung oder beides einzugeben.
  5. Klicken Sie auf Übernehmen, um die Änderungen am MQSendeknoten vorzunehmen, ohne den Eigenschaftendialog zu schließen. Wählen Sie OK, um die Änderungen anzuwenden und den Eigenschaftendialog zu schließen.

    Klicken Sie auf Abbrechen, um den Dialog zu schließen und alle Änderungen zu verwerfen, die Sie an den Eigenschaften durchgeführt hatten.

Terminals verbinden

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.

Für koordinierte Transaktionen konfigurieren

Wenn Sie einen MQSendeknoten definieren, bestimmt die Option, die Sie für die Eigenschaft Transaktionsmodus auswählen, ob die Nachricht unter dem Synchronisationspunkt geschrieben wird:

  • Im Fall von Ja wird die Nachricht unter dem Synchronisationspunkt geschrieben (d. h. in einer WebSphere MQ-Arbeitseinheit).
  • Wenn Sie Automatisch (Standardeinstellung) auswählen, wird die Nachricht unter dem Synchronisationspunkt geschrieben, wenn die eingehende Eingabenachricht als persistent markiert ist.
  • Im Fall von Nein wird die Nachricht nicht unter dem Synchronisationspunkt geschrieben.

Eine andere Eigenschaft des MQSendeknotens - Persistenzmodus - bestimmt, ob die Ausgabenachricht als persistent markiert wird, wenn sie in die Ausgabewarteschlange eingereiht wird:

  • Im Fall von Ja wird die Nachricht als persistent markiert.
  • Bei Automatisch (Standardeinstellung) wird die Nachrichtpersistenz durch die Eigenschaften der eingehenden Nachricht bestimmt, wie im MQMD (der WebSphere MQ-Nachrichtendeskriptor) festgelegt.
  • Im Fall von Nein wird die Nachricht nicht als persistent markiert.
  • Wenn Sie Wie für Warteschlange definiert wählen, wird die Nachrichtenpersistenz so festgelegt, wie in der WebSphere MQ-Warteschlange vom MQSendeknoten definiert wurde, der die Option MQPER_PERSISTENCE_AS_Q_DEF im MQMD angibt.

Terminals und Eigenschaften

Die Terminals des MQSendeknotens werden in der folgenden Tabelle beschrieben.

Terminal Beschreibung
Eingabe Das Eingabeterminal, das eine Nachricht für die Verarbeitung durch den Knoten akzeptiert.
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 weitergeleitet wird, wenn sie erfolgreich in die Ausgabewarteschlange eingereiht wurde und wenn eine weitere Verarbeitung in diesem Nachrichtenfluss erforderlich ist.

Die folgenden Tabellen beschreiben die Knoteneigenschaften; die Spalte mit der Überschrift 'O' gibt an, dass die Eigenschaft obligatorisch ist (beim Eigenschaftendialog mit einem Stern markiert, wenn Sie einen Wert eingeben müssen, falls kein Standardwert definiert ist); die Spalte mit der Überschrift 'K' gibt an, ob die Eigenschaft konfigurierbar ist (Sie können den Wert ändern, wenn Sie den Nachrichtenfluss der BAR-Datei hinzufügen, um sie einzusetzen).

Die Grundeigenschaften des MQSendeknotens werden in der folgenden Tabelle 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 (mittels MQPUT) Nachrichten einreiht.

Die erweiterten Eigenschaften des MQSendeknotens werden in der folgenden Tabelle beschrieben.

Eigenschaft O K Standardwert Beschreibung
Zielmodus Ja Nein Name der Warteschlange Die Warteschlangen, zu der die Ausgabenachricht gesendet wird. Gültige Werte sind , Warteschlange für Antwortnachrichten und Warteschlangenname.
Transaktionsmodus Ja Nein Automatisch Transaktionsorientierte Einreihung der Nachricht. Gültige Werte sind Automatisch, Ja und Nein.
Persistenzmodus Ja Nein Automatisch Persistente Einreihung der Nachricht. Gültige Werte sind Automatisch, Ja, Nein und Wie für Warteschlange definiert.
Neue Nachrichten-ID Ja Nein Gelöscht Generierung einer neuen Nachricht durch WebSphere MQ, um den Inhalt des MsgId-Feldes im MQMD zu ersetzen. Wenn Sie das Kontrollkästchen auswählen, wird diese Aktion ausgeführt.
Neue Korrelations-ID Ja Nein Gelöscht Generierung einer Korrelations-ID durch WebSphere MQ, um den Inhalt des CorrelId-Feldes im MQMD zu ersetzen. Wenn Sie das Kontrollkästchen auswählen, wird diese Aktion ausgeführt.
Segmentierung zulässig Ja Nein Gelöscht Falls angebracht, teilt WebSphere MQ die Nachricht im Warteschlangenmanager in Segmente auf. Wenn Sie das Kontrollkästchen auswählen, wird diese Aktion ausgeführt.
Nachrichtenkontext Ja Nein Gesamten Kontext übergeben Handhabung von Ursprungskontext. Gültige Werte sind Gesamten Kontext übergeben, ID übergeben, Gesamten Kontext setzen, ID setzen und Standardwert.
Alternative Benutzerberechtigung Ja Nein Gelöscht Verwendung der alternativen Berechtigung, wenn die Ausgabenachricht eingereiht wird. Wenn Sie das Kontrollkästchen auswählen, wird diese Aktion ausgeführt.

Die Anforderungseigenschaften des MQSendeknotens werden in der folgenden Tabelle beschrieben.

Eigenschaft O K Standardwert Beschreibung
Anforderung Ja Nein Gelöscht Generierung jeder Ausgabenachricht als Anforderungsnachricht. Wenn Sie das Kontrollkästchen auswählen, wird diese Aktion 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.

Die Beschreibungseigenschaften des MQSendeknotens werden in der folgenden Tabelle beschrieben.

Eigenschaft O K Standardwert Beschreibung
Kurzbeschreibung Nein Nein   Eine Kurzbeschreibung 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: 18.05.2006
ac04570_