Mit dem MQeInput-Knoten empfangen Sie Nachrichten von Clients, die unter Verwendung des WebSphere MQ Mobile Transport-Protokolls mit dem Broker verbunden sind.
Dieses Kapitel enthält folgende Abschnitte:
Der MQeInput-Knoten empfängt Nachrichten, die von einer bestimmten Verbindungswarteschlange auf dem WebSphere MQ Everyplace-Warteschlangenmanager des Brokers in einen Nachrichtenfluss gestellt wurden. Der Knoten richtet zudem die Verarbeitungsumgebung für die Nachricht ein. Sie müssen erst den WebSphere MQ Everyplace-Warteschlangenmanager erstellen und konfigurieren, bevor Sie einen Nachrichtenfluss, der diesen Knoten enthält, implementieren.
Nachrichtenflüsse, die Nachrichten über WebSphere MQ-Verbindungen bearbeiten, müssen immer mit einem MQeInput-Knoten starten. Sie können die Eigenschaften des MQeInput-Knotens so festlegen, dass die Art des Nachrichtenempfangs gesteuert wird. Beispielsweise können Sie angeben, dass eine Nachricht unter Transaktionssteuerung verarbeitet werden soll.
Wenn Sie Nachrichtenflüsse, die WebSphere MQ Everyplace-Knoten enthalten, 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 Nachrichtenflüssen müssen alle auf denselben WebSphere MQ Everyplace-Warteschlangenmanagernamen verweisen. Wird diese Rahmenbedingung nicht eingehalten, wird beim Implementieren ein Fehler gemeldet.
Der MQeInput-Knoten bearbeitet Nachrichten in den folgenden Nachrichtendomänen:
Sie können jeden der unterstützten Sendeknoten, einschließlich der benutzerdefinierten Sendeknoten, in einen Nachrichtenfluss aufnehmen, der mit einem MQeInput-Knoten beginnt; es ist nicht erforderlich, einen MQeOutput-Knoten aufzunehmen. 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. Diese Version ist mit neueren Versionen von WebSphere MQ Everyplace kompatibel. Clients, die spätere Versionen von WebSphere MQ Everyplace verwenden (z. B. 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 eigene Codestufe verwenden muss.
Sie können keine MQeInput-Knoten in Nachrichtenflüssen verwenden, die Sie
auf z/OS-Systemen einsetzen.
Wenn Sie einen Nachrichtenfluss erstellen, der als untergeordneter Nachrichtenfluss eingesetzt werden soll, können Sie keinen Standardempfangsknoten verwenden. Sie müssen eine Instanz des Input-Knotens als ersten Knoten verwenden, um ein Eingangsterminal für den untergeordneten Nachrichtenfluss zu erstellen.
Wenn Ihr Nachrichtenfluss keine Nachrichten über WebSphere MQ-Verbindungen empfängt, können Sie einen der unterstützten Empfangsknoten auswählen.
Der MQeInputknoten ist in der WebSphere MQ-Ablage der Palette enthalten und wird in der Workbench durch folgendes Symbol dargestellt:
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 dem PDA über eine globale Satellitennavigationsverbindung eine Nachricht an einen MQeInput-Knoten. Die Daten werden unter Verwendung eines Compute-Knotens bearbeitet, und ein Publication-Knoten veröffentlicht eine -Nachricht, sodass 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.
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.
Nachdem Sie eine Instanz des MQeInput-Knotens in einen Nachrichtenfluss eingereiht haben, können Sie den Knoten konfigurieren; siehe Nachrichtenflussknoten konfigurieren. Die Knoteneigenschaften werden in der Eigenschaftenansicht angezeigt. Klicken Sie zum Anzeigen der Knoteneigenschaften im Eigenschaftendialog entweder doppelt auf den Knoten, oder klicken Sie mit der rechten Maustaste und anschließend auf Eigenschaften.
Alle verbindlichen Eigenschaften, für die Sie einen Wert eingeben müssen (d. h. Eigenschaften ohne definierten Standardwert), sind mit einem Sternchen gekennzeichnet.
Konfigurieren Sie den MQeInput-Knoten folgendermaßen:
<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.
Lassen Sie das Feld Nachrichtengruppe leer, wenn Sie Parser vom Typ XML, XMLNS, XMLNSC, JMS, MIME und BLOB verwenden.
Geben Sie für XML-, XMLNS-, XMLNSC-, JMS-, MIME-, BLOB- und IDOC-Parser unter Nachrichtentyp keinen Wert ein.
Lassen Sie das Nachrichtenformat bei den XML-, XMLNS-, XMLNSC-, JMS-, MIME- und BLOB-Parsern leer.
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.
Wenn Sie das Kontrollkästchen aktivieren, wird die Definition der Eigenschaften aus der unter Name der Konfigurationsdatei (siehe nachfolgende Beschreibung) angegebenen Datei extrahiert, mit Ausnahme der folgenden Eigenschaften:
Es kann nur ein Warteschlangenmanager von WebSphere MQ Everyplace unterstützt werden. Nur eine Ausführungsgruppe kann MQeInput-Knoten bzw. MQeOutput-Knoten enthalten. Diese Eigenschaft muss daher in jedem MQeInput-Knoten in allen Nachrichtenflüssen, die Sie im selben Broker einsetzen, denselben Wert aufweisen.
Da es sich bei Kanälen um persistente logische Einheiten handelt, die länger als eine einzelne Warteschlangenmanageranfrage bestehen und Netzwerkzusammenbrüche überdauern können, muss unter Umständen für Kanäle, die für eine gewisse Zeit inaktiv waren, ein Zeitlimit festgelegt werden.
Der MQeInput-Knoten leitet jede Nachricht, die er erfolgreich empfängt, an das Ausgabeterminal weiter; im Fehlerfall wird die Nachricht wiederholt. Wenn das Zeitlimit hierfür (festgelegt durch das Attribut 'BackoutThreshold' der Eingabewarteschlange) abläuft, wird die Nachricht an das Fehlerterminal weitergeleitet. Sie können Knoten mit diesem Terminal verbinden, um diese Situation zu handhaben. Wenn keine Verbindung zum Fehlerterminal besteht, wird die Nachricht in die Rücksetzungswarteschlange geschrieben.
Wenn die Nachricht von diesem Knoten abgefangen wird, nachdem eine Ausnahmebedingung weiter vorne im Nachrichtenfluss ausgelöst wurde, wird die Nachricht an das Catch-Terminal weitergeleitet. Wenn keine Verbindung zum Catch-Terminal besteht, durchläuft die Nachricht den Knoten kontinuierlich in einer Schleife, 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.
Wenn Sie einen MQeInput-Knoten in einen Nachrichtenfluss einschließen, definiert der Wert, den Sie für den Transaktionsmodus festgelegt haben, ob die Nachrichten unter der Synchronisationspunktsteuerung empfangen werden:
Der MQeOutput-Knoten ist der einzige Sendeknoten, der so konfiguriert werden kann, dass diese Option außer Kraft gesetzt wird.
In der folgenden Tabelle werden die MQeInput-Knotenterminals beschrieben .
Terminal | Beschreibung |
---|---|
Fehlerterminal | Das Ausgabeterminal, an das die Nachricht geleitet wird, wenn ein Fehler auftritt. |
Ausgabeterminal | 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 den folgenden Tabellen werden die Knoteneigenschaften beschrieben. Die Spalte O zeigt an, ob die Eigenschaft obligatorisch ist (markiert mit einem Sternchen, wenn ein Wert eingegeben werden muss, weil kein Standardwert definiert ist). Die Spalte K zeigt an, ob die Eigenschaft konfigurierbar ist (Wert kann geändert werden, wenn der Nachrichtenfluss zur BAR-Datei hinzugefügt wird, um ihn einzusetzen).
In der folgenden Tabelle werden die Beschreibungseigenschaften des MQeInput-Knotens beschrieben.
Eigenschaft | O | K | Standardwert | Beschreibung |
---|---|---|---|---|
Knotenname | Nein | Nein | MQeInput | Der Name des Knotens. |
Kurzbeschreibung | Nein | Nein | Kurze Beschreibung des Knotens | |
Ausführliche Beschreibung | Nein | Nein | Text, der den Zweck des Knotens im Nachrichtenfluss beschreibt |
Die Standardeigenschaften des MQeInput-Knotens werden in der folgenden Tabelle beschrieben.
Eigenschaft | O | K | Standardwert | Beschreibung |
---|---|---|---|---|
Nachrichtendomäne | Nein | Nein | Die Domäne für die Syntaxanalyse der ankommenden Nachricht. | |
Nachrichtengruppe | Nein | Nein | Der Name oder die ID der Nachrichtengruppe, in der die ankommende Nachricht definiert ist. | |
Nachrichtentyp | 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. |
Die allgemeinen Eigenschaften des MQeInput-Knotens werden in der folgenden Tabelle beschrieben.
Eigenschaft | O | K | Standardwert | Beschreibung |
---|---|---|---|---|
Warteschlangenname | Ja | Ja | Der Name der WebSphere MQ Everyplace-Brückenwarteschlange, aus der dieser Knoten Nachrichten zur Verarbeitung durch diesen Nachrichtenfluss abruft. | |
Trace | Ja | Nein | Keiner | 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 | Durch diese Eigenschaft wird gesteuert, ob die ankommende Nachricht unter Synchronisationspunktsteuerung empfangen wird. Gültige Werte sind Automatisch, Ja und Nein. |
Konfigurationsdatei verwenden | Ja | Nein | Nicht ausgewählt | Wenn Sie das Kontrollkästchen aktivieren, wird für diesen Knoten eine Konfigurationsdatei verwendet. |
Name der Konfigurationsdatei | Ja | Ja | \MQeconfig.ini | Der Name der zu verwendenden Konfigurationsdatei, wenn das Kontrollkästchen Konfigurationsdatei verwenden aktiviert ist. |
Name des Warteschlangenmanagers | Ja | Ja | ServerQM1 | Der Name des WebSphere MQ Everyplace-Warteschlangenmanagers. |
Die Kanaleigenschaften des MQeInput-Knotens werden in der folgenden Tabelle beschrieben.
Eigenschaft | O | K | Standardwert | Beschreibung |
---|---|---|---|---|
Max. Anz. Kanäle | Ja | Nein | 0 | Die maximal vom WebSphere MQ Everyplace-Warteschlangenmanager unterstützte Anzahl von Kanälen. |
Die Registry-Eigenschaften des MQeInput-Knotens werden in der folgenden Tabelle beschrieben.
Eigenschaft | O | K | Standardwert | Beschreibung |
---|---|---|---|---|
Registry-Typ | Ja | Ja | FileRegistry | Die Art der zu verwendenden Registry-Informationen. Gültige Werte sind FileRegistry und PrivateRegistry. |
Verzeichnis | Ja | Ja | \ServerQM1\registry | Das Speicherverzeichnis der Registry-Datei (nur gültig, wenn FileRegistry ausgewählt ist). |
PIN | Ja | Ja | Die PIN, die mit dem WebSphere MQ Everyplace-Warteschlangenmanager verknüpft ist (nur gültig, wenn PrivateRegistry ausgewählt ist). | |
PIN für Zertifikatsanforderung | Ja | Ja | Die PIN für die Authentifizierungsanfrage (nur gültig, wenn PrivateRegistry ausgewählt ist). | |
Kennwort für Schlüsselring | Ja | Ja | Das Kennwort, mit dem Verschlüsselungsschlüssel angezeigt werden (nur gültig, wenn PrivateRegistry ausgewählt ist). | |
Zertifikatshost | Ja | Ja | Name des Zertifikatservers (nur gültig, wenn PrivateRegistry ausgewählt ist). | |
Zertifikatsport | Ja | Ja | Port des Zertifikatservers (nur gültig, wenn PrivateRegistry ausgewählt ist). |
Die Listener-Eigenschaften des MQeInput-Knotens werden in der folgenden Tabelle beschrieben.
Eigenschaft | O | K | Standardwert | 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. |
Zeitlimit (Sekunden) | Ja | Ja | 300 | Das Abfrageintervall von WebSphere MQ Everyplace (in Sekunden). |