MQeEmpfangsknoten (MQeInput)

Achtung: Die Verwendung von Nachrichtenflüssen mit MQeEmpfangs- und MQeSendeknoten wird in WebSphere Message Broker Version 6.0 nicht weiter unterstützt. Das hier beschriebene Verhalten ist nur für die Implementierung von Version 6.0 in eine frühere Version und zur Bereitstellung einer Route für die Migration vorgesehen. Überarbeiten Sie Ihre Nachrichtenflüsse, um die MQe-Knoten zu entfernen und sie durch MQ-Knoten zu ersetzen, die für Ihre Spezifikationen konfiguriert und für die Konfiguration Ihres MQe-Gateways koordiniert wurden. Weiter Informationen finden Sie unter Nachrichtenfluss mit WebSphere MQ Everyplace-Knoten migrieren.

Dieses Kapitel enthält folgende Abschnitte:

Zweck

Mit dem MQeEmpfangsknoten (MQeInput) empfangen Sie Nachrichten von Clients, die unter Verwendung des WebSphere MQ Mobile Transport-Protokolls mit dem Broker verbunden sind.

Der MQeEmpfangsknoten empfängt Nachrichten, die von einer bestimmten Verbindungswarteschlange auf dem WebSphere MQ Everyplace-Warteschlangenmanager des Brokers in einen Nachrichtenfluss gestellt wurden. Der Knoten errichtet zudem die Verarbeitungsumgebung für die Nachricht. Sie müssen erst den WebSphere MQ Everyplace-Warteschlangenmanager erstellen und konfigurieren, bevor Sie einen Nachrichtenfluss mit diesem Knoten implementieren.

Nachrichtenflüsse, die Nachrichten über WebSphere MQ Everyplace-Verbindungen bearbeiten, müssen immer mit einem MQeEmpfangsknoten starten. Sie können die Eigenschaften des MQeEmpfangsknotens festlegen, um die Weise zu steuern, in der die Nachrichten empfangen werden. Sie können beispielsweise festlegen, dass eine Nachricht unter Transaktionssteuerung verarbeitet werden soll.

Wenn Sie Nachrichtenflüsse mit WebSphere MQ Everyplace-Knoten auf einem Broker einsetzen, müssen Sie sie unabhängig von der Anzahl der Nachrichtenflüsse in einer einzelnen Ausführungsgruppe einsetzen. Die WebSphere MQ Everyplace-Knoten in den Flüssen müssen alle auf denselben WebSphere MQ Everyplace-Warteschlangenmanagernamen verweisen. Wird diese Rahmenbedingung nicht eingehalten, tritt bei der Einsetzung ein Fehler auf.

Der MQeEmpfangsknoten bearbeitet Nachrichten in den folgenden Nachrichtendomänen:

  • MRM
  • XML
  • XMLNS
  • JMSMap
  • JMSStream
  • MIME
  • BLOB

Wenn Sie einen Sendeknoten in einen Nachrichtenfluss aufnehmen, der mit einem MQeEmpfangsknoten beginnt, können Sie einen beliebigen unterstützten Sendeknoten einschließlich benutzerdefinierter Sendeknoten verwenden; es muss sich hierbei nicht um einen MQeSendeknoten handeln. Sie können einen Nachrichtenfluss erstellen, der Nachrichten von WebSphere MQ Everyplace-Clients empfängt und für Clients generiert, die für die Verbindung mit dem Broker eines der unterstützten Transportprotokolle verwenden. Dies ist möglich, weil Sie den Nachrichtenfluss so konfigurieren können, dass er beim Broker die erforderliche Konvertierung anfordert.

WebSphere MQ Everyplace Version 1.2.6 wird von WebSphere Message Broker verwendet. Sie ist kompatibel mit den nachfolgenden Versionen von WebSphere MQ Everyplace. Clients, die spätere Versionen von WebSphere MQ Everyplace verwenden, beispielsweise Version 2.0, funktionieren ordnungsgemäß, wenn sie an diesen Knoten angeschlossen werden, obwohl die zusätzlichen Funktionen, die in Version 1.2.6 nicht unterstützt werden (z. B. JMS-Unterstützung) nicht funktionieren.

Warteschlangenmanager können nicht zwischen verschiedenen Versionen von WebSphere MQ Everyplace ausgetauscht werden. Knoten müssen einen Warteschlangenmanager verwenden, der mit Version 1.2.6 erstellt wurde. Analog hierzu gilt, dass der Client bei der Erstellung eines WS-Managers seine Codestufe verwenden muss.

Sie können keine MQeEmpfangsknoten in Nachrichtenflüssen verwenden, die Sie in z/OS-Systemen einsetzen.

Wenn Sie einen Nachrichtenfluss erstellen, der als untergeordneter Fluss verwendet werden soll, können Sie keinen Standardempfangsknoten verwenden: Sie müssen eine Instanz des Empfangsknotens als ersten Knotenverwenden, um ein Eingangsterminal für den untergeordneten Fluss zu erstellen.

Wenn Ihr Nachrichtenfluss keine Nachrichten über WebSphere MQ-Verbindungen empfängt, können Sie einen der folgenden übrigen Empfangsknoten auswählen.

Der MQeEmpfangsknoten wird in der Workbench durch folgendes Symbol dargestellt:

Symbol für MQeEmpfangsknoten

Den MQeEmpfangsknoten in einem Nachrichtenfluss verwenden

Stellen Sie sich als Beispiel für die Verwendung dieses Knotens einen Landwirt vor, der seine Felder kontrolliert, um deren Bewässerung zu prüfen. Bei dieser Arbeit verwendet er einen PDA, auf dem WebSphere MQ Everyplace installiert ist. Er entdeckt einen Bereich, der bewässert werden muss, und sendet mit Hilfe des PDA und eines globalen Satellitennavigationslinks eine Nachricht an einen MQeEmpfangsknoten. Die Daten werden unter Verwendung eines Berechnungsknotens bearbeitet, und ein Veröffentlichungsknoten veröffentlicht eine -Nachricht, so dass ein SCADA-Ferngerät die Nachricht aufnehmen und die Bewässerungssprenkler aktivieren kann. Wenige Minuten nach Senden der Nachricht wird das Feld mit Wasser versorgt.

Dokumentation zu WebSphere MQ Everyplace

Weitere Informationen zu WebSphere MQ Everyplace und den Eigenschaften des Knotens finden Sie in der Dokumentation zu WebSphere MQ Everyplace unter Webseite von WebSphere MQ.

MQeEmpfangsknoten konfigurieren

Wenn Sie eine Instanz des MQeEmpfangsknotens in einen Nachrichtenfluss gestellt 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 Standardeigenschaften des Knotens im Eigenschaftendialogfeld 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 MQeEmpfangsknoten wie folgt:

  1. Wählen Sie im Navigator des Eigenschaftendialogs 'Standardwert' aus, und legen Sie Werte für die Eigenschaften fest, mit denen Nachrichtendomäne, -gruppe, -typ und -format beschrieben werden und auf deren Grundlage der Knoten die syntaktische Analyse der ankommenden Nachricht durchführt. Legen Sie außerdem das Standardthema der Nachricht fest.
    • Verfügt die eingehende Nachricht über einen MQRFH2-Header, müssen Sie keine Werte für die Standardeigenschaften angeben, da die Werte vom <mcd>-Ordner im MQRFH2-Header abgeleitet werden können. Beispiel:
      <mcd><Msd>MRM</Msd><Set>DHM4UO906S001</Set><Type>receiptmsg1</Type>
      <Fmt>XML</Fmt></mcd>

      Wenn Sie Werte festlegen, die nicht mit denen im MQRFH2-Header übereinstimmen, haben die Werte aus dem MQRFH2-Header Vorrang.

    • Wählen Sie unter Nachrichtendomäne aus der Dropdown-Liste den Namen des von Ihnen verwendeten Parsers aus. Folgende Namen stehen zur Auswahl:
      • MRM
      • XML
      • XMLNS
      • XMLNSC
      • JMSMap
      • JMSStream
      • MIME
      • BLOB
      • IDOC
    • Wenn Sie den MRM- oder den IDOC-Parser verwenden, wählen Sie aus der Dropdown-Liste unter Nachrichtengruppe die entsprechende Nachrichtengruppe aus. Diese Liste wird mit den verfügbaren Nachrichtengruppen gefüllt, wenn Sie MRM oder IDOC als Domäne auswählen.

      Lassen Sie die Nachrichtengruppe bei den XML-, XMLNS-, XMLNSC-, JMS-, MIME- und BLOB-Parsern leer.

    • Wenn Sie den MRM-Parser verwenden, wählen Sie aus der Dropdown-Liste unter Nachrichtenart den entsprechenden Nachrichtentyp aus. Diese Liste wird mit Nachrichten aufgefüllt, die in der von Ihnen ausgewählten Nachrichtengruppe definiert sind.

      Lassen Sie das Feld Nachrichtenart bei XML-, XMLNS-, XMLNSC-, JMS-, MIME-, BLOB- und IDOC-Parsern leer.

    • Wenn Sie den MRM- oder den IDOC-Parser verwenden, wählen Sie das Format der Nachricht aus der Dropdown-Liste unter Nachrichtenformat aus. Diese Liste enthält alle physischen Formate, die Sie für diese Nachrichtengruppe definiert haben.

      Lassen Sie das Nachrichtenformat bei den XML-, XMLNS-, XMLNSC-, JMS-, MIME- und BLOB-Parsern leer.

    • Geben Sie unter Thema das Thema der Nachricht ein. Sie können im Themennamen alle Buchstaben verwenden. Wenn die Nachricht den MQeEmpfangsknoten passiert, wird der von Ihnen angegebene Themenname vorausgesetzt. (Wenn Sie Publish/Subscribe verwenden, können Sie ein Thema abonnieren und alle Nachrichten anzeigen, die den MQeEmpfangsknoten unter diesem Themennamen passiert haben.)
  2. Wählen Sie im Navigator des Eigenschaftendialogs die Option 'Allgemein', und geben Sie folgende Eigenschaften an:
    1. Geben Sie den Warteschlangennamen der WebSphere MQ Everyplace-Brückenwarteschlange an, von der dieser Empfangsknoten Nachrichten abruft. Wenn die Warteschlange nicht existiert, wird sie für Sie erstellt, wenn der Nachrichtenfluss im Broker eingesetzt wird.
    2. Stellen Sie die Trace-Stufe ein, die für diesen Knoten verwendet werden soll. Wenn die Trace-Funktion aktiviert ist, werden die Trace-Informationen in der unter Trace-Dateiname angegebenen Datei aufgezeichnet (siehe nachfolgende Beschreibung). Wählen Sie eine der folgenden Optionen:
      • Keine. Dies ist die Standardeinstellung. Es wird nur eine Traceausgabe erstellt, wenn ein schwer wiegender Fehler auftritt.
      • Standard. Es wird eine Mindest-Traceausgabe generiert, um die gesamten Aktivitäten des Knotens anzugeben.
      • Debug. Trace-Information werden auf einer Ebene aufgezeichnet, die Ihnen bei der Fehlerbehebung von WebSphere MQ Everyplace-Programmen hilft.
      • Vollständig. Alle verfügbaren Debuginformationen werden aufgezeichnet, um eine umfassende Aufzeichnung der Knotenaktivitäten zu erhalten.

      Wenn Sie als Tracestufe Debug oder Vollständig festlegen, wirkt sich dies auf die Leistung von WebSphere MQ Everyplace aus, und es können signifikante Tracedateien generiert werden. Verwenden Sie diese Optionen nur für kurze Zeit.

    3. Unter Trace-Dateiname geben Sie den Namen der Datei an, in die die Trace-Informationen geschrieben werden. Die Verzeichnisstruktur, in der die Datei angegeben wird, muss bereits vorhanden sein: sie kann nicht während des Betriebs erstellt werden.
    4. Wählen Sie die Option Transaktionsmodus, um die transaktionsorientierten Merkmale zur Handhabung dieser Nachricht festzulegen:
      • Wenn Sie die Option Automatisch auswählen, wird die ankommende Nachricht unter der Synchronisationspunktsteuerung empfangen, wenn sie als persistent markiert ist (anderenfalls nicht). Die Transaktionalität aller abgeleiteten Nachrichten, die später von einem Sendeknoten gesendet werden, hängt vom eingehenden Persistenzmerkmal ab - es sei denn, vom Sendeknoten wurde die Transaktionalität explizit überschrieben.
      • Bei der Auswahl von Ja wird die ankommende Nachricht unter Synchronisationspunktsteuerung empfangen. Alle abgeleiteten Nachrichten, die später von einem Sendeknoten in derselben Instanz des Nachrichtenflusses gesendet werden, werden transaktionsorientiert gesendet - es sei denn, vom Sendeknoten wurde die Transaktionalität explizit überschrieben.
      • Bei der Auswahl von Nein wird die ankommende Nachricht nicht unter Synchronisationspunktsteuerung empfangen. Alle abgeleiteten Nachrichten, die nacheinander von einem Sendeknoten im Nachrichtenfluss gesendet wurden, werden nicht-transaktional gesendet, es sei denn, der Sendeknoten gibt an, dass die Nachricht unter die Synchronisationspunktsteuerung gestellt werden muss.
    5. Das Markierungsfeld Konfigurationsdatei verwenden ist standardmäßig nicht aktiviert. Die Werte für die Eigenschaften des MQeEmpfangsknotens stammen aus dem Eigenschaftendialogfeld.

      Wenn Sie das Markierungsfeld aktivieren, wird die Definition der Eigenschaften aus der unter Name der Konfigurationsdatei (siehe nachfolgende Beschreibung) angegebenen Datei mit folgender Ausnahme extrahiert:

      • Die allgemeinen Eigenschaften von Name der Warteschlange und Name der Konfigurationsdatei
      • Alle Standardeigenschaften
      Verwenden Sie eine Konfigurationsdatei nur, um zusätzliche Eigenschaften für den Knoten anzugeben. Wenn die im Eigenschaftendialog aufgeführten Eigenschaften für Ihre Zwecke ausreichen, sollte das Markierungsfeld Konfigurationsdatei verwenden nicht aktiviert werden.
    6. Wenn Sie das Markierungsfeld Konfigurationsdatei verwenden aktiviert haben, geben Sie den vollständigen Pfad und den Namen der Konfigurationsdatei für WebSphere MQ Everyplace unter Name der Konfigurationsdatei ein. Diese Datei muss auf dem System installiert sein, das jeden Broker unterstützt, in dem dieser Nachrichtenfluss eingesetzt wird. Wenn die Datei nicht vorhanden ist, wird ein Fehler beim Einsetzen des Nachrichtenflusses gemeldet. Der Standardname der Datei lautet MQeConfig.ini.
    7. Geben Sie unter Name des WS-Managers den Namen des Warteschlangenmanagers von WebSphere MQ Everyplace an. Dieser gehört nicht mit dem Warteschlangenmanager des Brokers zusammen, in dem Sie den Nachrichtenfluss mit diesem Knoten einsetzen.

      Es kann nur ein Warteschlangenmanager von WebSphere MQ Everyplace unterstützt werden. Nur eine Ausführungsgruppe kann MQeEmpfangs- bzw. MQeSendeknoten enthalten. Diese Eigenschaft muss daher in jedem MQeEmpfangsknoten aller Nachrichtenflüsse, die Sie im selben Broker einsetzen, denselben Wert aufweisen.

  3. Wählen Sie im Navigator des Eigenschaftendialogs die Option 'Kanal' aus, und legen Sie unter Max. Anz. Kanäle die maximale Anzahl der von WebSphere MQ Everyplace unterstützten Kanäle fest. Standardwert ist Null, d. h. es besteht keine Einschränkung.
  4. Wählen Sie im Navigator des Eigenschaftendialogs die Option 'Registrierungsdatenbank' aus, und geben Sie folgende Eigenschaften an:
    1. Wählen Sie aus der Dropdown-Liste unter der Eigenschaft Registry Type (Registrierungsdatenbanktyp) die Art der gewünschten Registrierungsdatenbank aus. Sie können einen der folgenden Werte auswählen:
      • File Registry (Dateiregistrierungsdatenbank). Informationen zur Registrierungsdatenbank und Sicherheit finden Sie unter der nachfolgend aufgeführten Option Verzeichnis.
      • Private Registry (Private Registrierungsdatenbank). Sie können den Warteschlangenmanager manuell in WebSphere MQ Everyplace erstellen und dabei die erforderlichen Sicherheitsparameter angeben.
    2. Geben Sie unter Verzeichnis das Verzeichnis an, in dem sich die Registrierungsdatei befindet. Es ist nur gültig, wenn Sie als Registry Type (Registrierungsdatenbanktyp) die Option File Registry (Dateiregistrierungsdatenbank) ausgewählt haben.
    3. Wenn Sie als Registry Type (Registrierungsdatenbanktyp) die Option Private Registry (Private Registrierungsdatenbank) ausgewählt haben, müssen Sie folgende Eigenschaften angeben:
      • Geben Sie für den zugehörigen Warteschlangenmanager eine PIN ein. Ausführliche Informationen hierzu finden Sie in der Dokumentation zu WebSphere MQ Everyplace.
      • Geben Sie für Authentifizierungsanforderungen eine PIN für Zertifikatsanforderung an. Ausführliche Informationen hierzu finden Sie in der Dokumentation zu WebSphere MQ Everyplace.
      • Geben Sie ein Kennwort für Schlüsselring an, das als Verschlüsselungsstartwert bei der Generierung von Verschlüsselungsschlüsseln dient. Ausführliche Informationen hierzu finden Sie in der Dokumentation zu WebSphere MQ Everyplace.
      • Geben Sie unter Zertifikatshost den Namen des Zertifikatservers an, den WebSphere MQ Everyplace zur Authentifizierung verwendet. Ausführliche Informationen hierzu finden Sie in der Dokumentation zu WebSphere MQ Everyplace.
      • Geben Sie unter Zertifikatsport die Nummer des Ports für den Zertifikatserver an, den WebSphere MQ Everyplace zur Authentifizierung verwendet. Ausführliche Informationen hierzu finden Sie in der Dokumentation zu WebSphere MQ Everyplace.
  5. Wählen Sie im Navigator des Eigenschaftendialogs die Option 'Empfangsprogramm' (Listener) aus, und geben Sie folgende Eigenschaften an, die den Anschlusstyp für WebSphere MQ Everyplace festlegen:
    1. Wählen Sie unter Empfangsprogrammtyp aus der Dropdown-Liste den gewünschten Adaptertyp aus. Der Standardtyp ist Http. Sie können aber auch Länge oder Protokoll auswählen. Ausführliche Informationen hierzu finden Sie in der Dokumentation zu WebSphere MQ Everyplace.
    2. Geben Sie unter Hostname den Hostnamen des Servers an. Stellen Sie hier den Sonderwert localhost oder den TCP/IP-Adresswert 127.0.0.1 (der Standardwert) ein. Beide Angaben werden in den richtigen Hostnamen des Servers aufgelöst, in dem der Nachrichtenfluss eingesetzt wird. Sie können auch einen beliebigen gültigen Hostnamen oder eine beliebige gültige TCP/IP-Adresse in Ihrem Netz verwenden, dabei müssen Sie jedoch für jeden Broker, in dem Sie den Nachrichtenfluss einsetzen, einen anderen Nachrichtenfluss verwenden oder diese Eigenschaft beim Einsetzen konfigurieren.
    3. Geben Sie unter Port die Portnummer an, auf der WebSphere MQ Everyplace empfangsbereit ist. Wenn ein Nachrichtenfluss, der in einem einzelnen Broker eingesetzt wird, mehrere MQeEmpfangsknoten enthält, muss jeder MQeEmpfangsknoten eine andere Nummer für diese Eigenschaft haben. Stellen Sie auch sicher, dass die von Ihnen angegebene Nummer keinen Konflikt mit anderen Empfangsprogrammen im Broker-System auslöst, beispielsweise mit WebSphere MQ. Der Standardwert lautet 8081.
    4. Geben Sie unter Zeitintervall den Zeitlimitwert in Sekunden, nach dem Leerlaufkanäle das zulässige Zeitlimit überschreiten. Der Standardwert lautet 300 Sekunden.

      Da es sich bei Kanälen um persistente logische Einheiten handelt, die länger dauern als eine einzelne Warteschlangenmanageranfrage und die Netzwerkzusammenbrüche überdauern können, muss unter Umständen für Kanäle, die für eine gewisse Zeit inaktiv waren, ein Zeitlimit eingerichtet werden.

  6. Wählen Sie im Navigator des Eigenschaftendialogs die Option 'Beschreibung' aus, um ein kurze und/oder ausführliche Beschreibung einzugeben.
  7. Klicken Sie auf Übernehmen, um die Änderungen am MQeEmpfangsknoten 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

Der MQeEmpfangsknoten leitet jede Nachricht, die er erfolgreich abruft, an das Ausgangsterminal weiter. Schlägt dieser Vorgang fehl, wird die Nachricht erneut weitergeleitet. Wenn das Zeitlimit hierfür (definiert vom BackoutThreshold-Attribut der Eingabewarteschlange) abläuft, wird die Nachricht an das Fehlerterminal weitergeleitet. Sie können Knoten mit diesem Terminal verbinden, um diesen Zustand zu beheben. Wenn Sie keine Verbindung zum Fehlerterminal hergestellt haben, wird die Nachricht in die Rücksetzungswarteschlange geschrieben.

Wenn die Nachricht von diesem Knoten abgefangen wird, nachdem eine Ausnahmebedingung weiter vorne im Nachrichtenfluss ausgegeben wurde, wird die Nachricht an das Catch-Terminal weitergeleitet. Wenn Sie keine Verbindung zum Catch-Terminal hergestellt haben, durchläuft die Nachricht kontinuierlich in einer Schleife den Knoten, bis das Problem behoben ist. Sie müssen eine Rücksetzungswarteschlange bzw. eine Warteschlange für nicht zustellbare Nachrichten (DLQ) definieren, um diesen Schleifendurchlauf zu vermeiden.

Koordinierte Transaktionen konfigurieren

Wenn Sie einen MQeEmpfangsknoten in einen Nachrichtenfluss einschließen, definiert der Wert, den Sie für die Eigenschaft Transaktionsmodus festgelegt haben, ob die Nachrichten unter der Synchronisationspunktsteuerung empfangen werden:

  • Der Wert Ja (Standardeinstellung) bewirkt, dass die Nachricht unter der Synchronisationspunktsteuerung empfangen wird (d. h. in einer Arbeitseinheit von WebSphere MQ). Alle Nachrichten, die nacheinander von einem Sendeknoten in derselben Instanz des Nachrichtenflusses gesendet wurden, werden unter die Synchronisationspunktsteuerung gestellt, es sei denn, der Sendeknoten hat dies explizit überschrieben.
  • Wenn Sie Automatisch auswählen, wird die Nachricht unter dem Synchronisationspunkt empfangen, wenn die eingehende Nachricht als persistent markiert ist. Ansonsten ist dies nicht der Fall. Alle Nachrichten, die nacheinander von einem Sendeknoten gesendet wurden, werden - wie vom Persistenzmerkmal der ankommenden Nachricht bestimmt - unter Synchronisationspunktsteuerung gestellt, es sei denn, der Sendeknoten hat dies explizit überschrieben.
  • Der Wert Nein bewirkt, dass die Nachricht nicht unter der Synchronisationspunktsteuerung empfangen wird. Alle Nachrichten, die nacheinander von einem Sendeknoten im Nachrichtenfluss gesendet wurden, werden nicht unter die Synchronisationspunktsteuerung (syncpoint-Bedingung) gestellt, es sei denn, ein einzelner Sendeknoten hat dies angegeben.

(Der MQSendeknoten ist der einzige Sendeknoten, den Sie so konfigurieren können, dass er diese Option überschreibt.)

Terminals und Eigenschaften

In der nachfolgenden Tabelle werden die Terminals des MQeEmpfangsknotens beschrieben.

Terminal Beschreibung
Fehlerterminal Das Ausgabeterminal, an das die Nachricht geleitet wird, wenn ein Fehler auftritt.
Ausgangsterminal Das Ausgabeterminal, an das die Nachricht geleitet wird, wenn sie erfolgreich von der WebSphere MQ Everyplace-Warteschlange abgerufen wurde.
Catch-Terminal Das Ausgabeterminal, an das die Nachricht geleitet wird, wenn nachgeschaltet eine Ausnahmebedingung ausgegeben und von diesem Knoten abgefangen wurde.

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 Standardeigenschaften des MQeEmpfangsknotens beschrieben.

Eigenschaft M C Standard Beschreibung
Nachrichtendomäne Nein Nein   Die Domäne, die für die Syntaxanalyse der ankommenden Nachricht verwendet wird.
Nachrichtengruppe Nein Nein   Der Name oder die ID der Nachrichtengruppe, in der die ankommende Nachricht definiert ist.
Nachrichtenart Nein Nein   Der Name der ankommenden Nachricht.
Nachrichtenformat Nein Nein   Der Name des physischen Formats der ankommenden Nachricht.
Thema Nein Ja   Das Standardthema der Eingabenachricht.

In der nachfolgenden Tabelle werden die allgemeinen Eigenschaften des MQeEmpfangsknotens beschrieben.

Eigenschaft M C Standard Beschreibung
Name der Warteschlange Ja Ja   Der Name der WebSphere MQ Everyplace-Brückenwarteschlange, aus der dieser Knoten Nachrichten zur Verarbeitung durch diesen Nachrichtenfluss abruft.
Trace Ja Nein Keine Die für diesen Knoten erforderliche Tracestufe. Gültige Werte sind Keine, Standard, Debug und Vollständig.
Name der Tracedatei Ja Ja \MQeTraceFile.trc Der Name der Datei, in die Tracesätze geschrieben werden.
Transaktionsmodus Ja Nein Ja Gibt an, ob die ankommende Nachricht unter Synchronisationspunktsteuerung empfangen wird. Gültige Werte sind Automatisch, Ja und Nein.
Konfigurationsdatei verwenden Ja Nein Nicht ausgewählt Für diesen Knoten wird eine Konfigurationsdatei verwendet. Wenn Sie das Markierungsfeld aktivieren, wird der Vorgang ausgeführt.
Name der Konfigurationsdatei Ja Ja \MQeconfig.ini Der Name der zu verwendenden Konfigurationsdatei, wenn das Markierungsfeld Konfigurationsdatei verwenden aktiviert ist.
Name des WS-Managers Ja Ja ServerQM1 Der Name des WebSphere MQ Everyplace-Warteschlangenmanagers.

In der nachfolgenden Tabelle werden die Kanaleigenschaften des MQeEmpfangsknotens beschrieben.

Eigenschaft M C Standard Beschreibung
Max. Anz. Kanäle Ja Nein 0 Die maximal vom WebSphere MQ Everyplace-Warteschlangenmanager unterstützte Anzahl von Kanälen.

In der nachfolgenden Tabelle werden die Eigenschaften der Registrierungsdatenbank des MQeEmpfangsknotens beschrieben.

Eigenschaft M C Standard Beschreibung
Typ Ja Ja File Registry (Dateiregistrierungsdatenbank) Die Art der zu verwendenden Informationen der Registrierungsdatenbank. Gültige Werte sind File Registry (Dateiregistrierungsdatenbank) und Private Registry (Private Registrierungsdatenbank).
Verzeichnis Ja Ja \ServerQM1\registry Das Speicherverzeichnis der Registrierungsdatei (nur gültig, wenn File Registry (Dateiregistrierungsdatenbank) ausgewählt ist).
PIN Ja Ja   Die PIN, die mit dem WebSphere MQ Everyplace-Warteschlangenmanager verknüpft ist (nur gültig, wenn Private Registry (Private Registrierungsdatenbank) ausgewählt ist).
PIN für Zertifikatsanforderung Ja Ja   PIN für die Authentifizierungsanfrage (nur gültig, wenn Private Registry (Private Registrierungsdatenbank) ausgewählt ist).
Kennwort für Schlüsselring Ja Ja   Das Kennwort, mit dem Verschlüsselungsschlüssel angezeigt werden (nur gültig, wenn Private Registry (Private Registrierungsdatenbank) ausgewählt ist).
Zertifikatshost Ja Ja   Name des Zertifikatservers (nur gültig, wenn Private Registry (Private Registrierungsdatenbank) ausgewählt ist).
Zertifikatsport Ja Ja   Der Port des Zertifikatservers (nur gültig, wenn Private Registry (Private Registrierungsdatenbank) ausgewählt ist).

In der nachfolgenden Tabelle werden die Empfangsprogramm-Eigenschaften des MQeEmpfangsknotens beschrieben.

Eigenschaft M C Standard Beschreibung
Empfangsprogrammtyp Ja Ja Http Der Adaptertyp für das Empfangsprogramm. Gültige Werte sind Http, Länge und Protokoll.
Hostname Ja Ja 127.0.0.1 Der Hostname des Servers.
Port Ja Ja 8081 Der Anschluss, an dem WebSphere MQ Everyplace empfangsbereit ist.
Zeitintervall Ja Ja 300 Das Abfrageintervall von WebSphere MQ Everyplace (in Sekunden).

In der nachfolgenden Tabelle werden die Beschreibungseigenschaften des MQeEmpfangsknotens 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
ac04600_