MQeEmpfangsknoten

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 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 implementieren, müssen Sie sie unabhängig von der Anzahl der Nachrichtenflüsse in einer einzelnen Ausführungsgruppe implementieren. 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 Implementierung 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 herbei 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. Ebenso muss der Client seine Codeebene beim Erstellen eines Warteschlangenmanagers verwenden.

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

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.
    • Wenn die ankommende Nachricht über einen MQRFH2-Header verfügt, müssen Sie keine Werte für die Standardeigenschaften festlegen, da Sie sie aus dem Ordner <mcd> im MQRFH2-Header ableiten 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 bei XML-, XMLNS-, XMLNSC-, JMS-, MIME- und BLOB-Parsern das Feld Nachrichtengruppe 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 bei XML-, XMLNS-, XMLNSC-, JMS-, MIME-, BLOB- und IDOC-Parsern das Feld Nachrichtentyp 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 bei XML-, XMLNS-, XMLNSC-, JMS-, MIME- und BLOB-Parsern das Feld Nachrichtenformat 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 die Optionen Veröffentlichen/Subskribieren (Publish/Subscribe) verwenden, können Sie ein Thema subskribieren und alle Nachrichten anzeigen, die den MQeEmpfangsknoten unter diesem Themennamen passiert haben.)
  2. Wählen Sie im Eigenschaften-Dialognavigator die Option Allgemein, und geben Sie folgende Eigenschaften an:
    1. Geben Sie den Namen der Warteschlange 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 implementiert 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 die unter Trace-Dateiname angegebene 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 Synchronisationspunktsteuerung empfangen, wenn sie als persistent markiert ist (anderenfalls nicht). Die Transaktionalität abgeleiteter Nachrichten, die nacheinander von einem Sendeknoten gesendet wurden, wird bestimmt durch das Persistenzmerkmal der ankommenden Nachricht, ausgenommen, der Sendeknoten hat die Transaktionalität explizit überschrieben.
      • Wenn Sie die Option Ja auswählen, wird die ankommende Nachricht unter Synchronisationspunktsteuerung empfangen. Alle abgeleiteten Nachrichten, die nacheinander von einem Sendeknoten in derselben Instanz des Nachrichtenflusses gesendet wurden, werden transaktional gesendet, ausgenommen, der Sendeknoten hat die Transaktionalität explizit überschrieben.
      • Wenn Sie die Option Nein auswählen, wird die ankommende Nachricht nicht unter Synchronisationspunktsteuerung empfangen. Alle abgeleiteten Nachrichten, die nacheinander von einem Sendeknoten im Nachrichtenfluss gesendet wurden, werden nicht-transaktional gesendet, ausgenommen, der Sendeknoten gibt an, dass die Nachricht unter Synchronisationspunktsteuerung gesetzt 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 implementiert wird. Wenn die Datei nicht vorhanden ist, wird ein Fehler beim Implementieren 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 implementieren.

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

  3. Wählen Sie im Eigenschaften-Dialognavigator die Option Kanal, und legen Sie unter Max. Anz. Kanäle die maximale Anzahl der von WebSphere MQ Everyplace unterstützten Kanäle fest. Der Standardwert ist null, d. h., es besteht keine Einschränkung.
  4. Wählen Sie im Eigenschaften-Dialognavigator die Registry-Option, und geben Sie folgende Eigenschaften an:
    1. Wählen Sie den Registry-Typ aus der Dropdown-Liste unter der Eigenschaft Registry Type (Registry-Typ) aus. Folgende Optionen stehen zur Auswahl:
      • File Registry (Dateiregistry). Informationen zur Registrierungsdatenbank und Sicherheit finden Sie unter der nachfolgend aufgeführten Option Verzeichnis.
      • Private Registry (Private Registrierung). 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 (Registry-Typ) die Option File Registry (Datei-Registry) ausgewählt haben.
    3. Wenn Sie als Registry Type (Registry-Typ) die Option Private Registrierung ausgewählt haben, müssen Sie folgende Eigenschaften angeben:
      • Geben Sie eine PIN für den zugeordneten Warteschlangenmanager an. 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 Eigenschaften-Dialognavigator die Option Empfangsprogramm (Listener), 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 implementiert 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 implementieren, einen anderen Nachrichtenfluss verwenden oder diese Eigenschaft beim Implementieren konfigurieren.
    3. Geben Sie unter Port die Portnummer an, auf der WebSphere MQ Everyplace empfangsbereit ist. Wenn ein Nachrichtenfluss, der in einem einzelnen Broker implementiert 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 beträgt 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 Eigenschaften-Dialognavigator die Option Beschreibung, 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

MQeEmpfangsknoten leitet jede Nachricht, die es empfängt, erfolgreich an den 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 Ausnahme weiter vorne im Nachrichtenfluss aufgetreten ist, 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 Synchronisationspunktsteuerung empfangen werden:

  • Der Wert Ja (Standardeinstellung) bewirkt, dass die Nachricht unter 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 Synchronisationspunktsteuerung gestellt, ausgenommen, 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, ausgenommen, der Sendeknoten hat dies explizit überschrieben.
  • Der Wert Nein bewirkt, dass die Nachricht nicht unter Synchronisationspunktsteuerung empfangen wird. Alle Nachrichten, die nacheinander von einem Sendeknoten im Nachrichtenfluss gesendet wurden, werden nicht unter Synchronisationspunktsteuerung gestellt, ausgenommen, 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 aufgefangen 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 Standardwert 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   Standardthema der Eingabenachricht

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

Eigenschaft M C Standardwert 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 Für diesen Knoten erforderliche Tracestufe. Gültige Werte sind Keine, Standard, Debug und Vollständig.
Name der Tracedatei Ja Ja \MQeTraceFile.trc Name der Datei, in die Tracesätze geschrieben werden
Transaktionsmodus Ja Nein Ja Empfang der ankommenden Nachricht unter Synchronisationspunktsteuerung. Gültige Werte sind Automatisch, Ja und Nein.
Konfigurationsdatei verwenden Ja Nein Gelöscht Verwenden Sie für diesen Knoten eine Konfigurationsdatei. Wenn Sie das Markierungsfeld aktivieren, wird der Vorgang ausgeführt.
Name der Konfigurationsdatei Ja Ja \MQeconfig.ini Name der zu verwendenden Konfigurationsdatei, wenn das Markierungsfeld Konfigurationsdatei verwenden aktiviert ist
Name des WS-Managers Ja Ja ServerQM1 Name des WebSphere MQ Everyplace-Warteschlangenmanagers

In der nachfolgenden Tabelle werden die Kanaleigenschaften des MQeEmpfangsknotens beschrieben.

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

In der nachfolgenden Tabelle werden die Registrierungseigenschaften des MQeEmpfangsknotens beschrieben.

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

In der nachfolgenden Tabelle werden die Empfangsprogrammeigenschaften des MQeEmpfangsknotens beschrieben.

Eigenschaft M C Standardwert Beschreibung
Empfangsprogrammtyp Ja Ja Http Adaptertyp für das Empfangsprogramm. Gültige Werte sind Http, Länge und Protokoll.
Hostname Ja Ja 127.0.0.1 Hostname des Servers.
Port Ja Ja 8081 Port, 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 Standardwert 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, 2005 Letzte Aktualisierung: Nov 17, 2005
ac04600_