Mithilfe des TCPIPClientReceive-Knotens können Sie Daten über eine TCP/IP-Clientverbindung empfangen.
Dieses Thema ist in folgende Abschnitte eingeteilt:
Der TCPIPClientReceive-Knoten wartet auf Daten, die in einer TCP/ IP-Verbindung empfangen werden sollen, und ruft die Daten ab. Wenn die Verbindung aufgehoben wird, wird eine Ausnahmebedingung ausgegeben.
Der Broker kann für die Verwendung von SSL für TCP/IP-Knoten konfiguriert werden. Informationen hierzu finden Sie im Abschnitt SSL und die TCP/IP-Knoten.
Sobald eine Verbindung hergestellt wurde, werden die Daten an den TCPIPClientReceive-Knoten gesendet. Wenn der TCPIPClientReceive-Knoten nicht alle Daten in dem über die Eigenschaft Zeitlimitüberschreitung bei Warten auf Datensatz angegebenen Zeitraum empfangen kann, wird die Nachricht an das Timeout-Terminal gesendet. Ist kein Timeout-Terminal angeschlossen, wird eine Ausnahmebedingung ausgelöst.
Die Eigenschaften in der lokalen Umgebung können die vom Knoten verwendete TCP/IP-Verbindung überschreiben.
Position in der lokalen Umgebung für die Eingabe beim Knoten | Beschreibung |
---|---|
$LocalEnvironment//TCPIP/Receive/Hostname | Der Hostname für die Herstellung einer Verbindung |
$LocalEnvironment//TCPIP/Receive/Port | Die Portnummer für die Herstellung einer Verbindung |
$LocalEnvironment/TCPIP/Receive/Id | Die ID des verwendeten Sockets. Diese ID ist eine interne Kennung, die von WebSphere Message Broker zur eindeutigen Identifizierung einer Verbindung verwendet wird. |
$LocalEnvironment/TCPIP/Receive/ReplyId | Die Antwort-ID, die in dieser Verbindung gespeichert werden soll. Diese ID kann verwendet werden, wenn die Daten auf einem Empfangsknoten zurückgegeben werden. Bei der Antwort-ID kann es sich um eine beliebige Textfolge handeln. |
$LocalEnvironment/TCPIP/Receive/Timeout | Der Zeitlimitwert, der beim Warten auf Daten in der TCP/IP-Clientverbindung verwendet wird. Dieser Wert setzt die auf dem Knoten angegebene Eigenschaft Zeitlimitüberschreitung beim Warten auf einen Datensatz außer Kraft. |
$LocalEnvironment/TCPIP/Receive/Length | Der Wert, mit dem die zu lesende Anzahl an Bytes bei der Verwendung von Datensätzen mit fester Größe außer Kraft gesetzt wird. Dieser Wert setzt die auf dem Knoten angegebene Eigenschaft Länge (Bytes) außer Kraft. Wenn die Eigenschaft Datensatzerkennung auf einen anderen Wert als Feste Länge gesetzt ist, wird das Feld der lokalen Umgebung ignoriert. Ist dieses Feld nicht vorhanden oder ergibt null, wird es ignoriert, und der Wert auf dem Knoten wird verwendet. |
Über diese Eigenschaften können die Verbindungsdetails (Hostname und Portnummer) sowie die verwendete Verbindung (ID) dynamisch ausgewählt werden. Außerdem kann die Antwort-ID für die Verbindung festgelegt werden. Auf diese Weise kann eine Zeichenfolge in der Verbindung gespeichert und in der lokalen Umgebung aller Daten, die von dieser Verbindung empfangen werden, angezeigt werden. Über diese Verbindung können Antwort-IDs von anderen TCP/IP-Knoten oder aus anderen Transportprotokollen, z. B. WebSphere MQ, gespeichert werden.
Wenn ein Datensatz abgerufen wurde, wird das Feld 'ConnectionDetails' in der lokalen Umgebung mit den Details der verwendeten Verbindung gefüllt.
Position in der lokalen Umgebung für die Ausgabe vom Knoten | Beschreibung |
---|---|
$LocalEnvironment/TCPIP/Receive/ConnectionDetails/Type | Der Client |
$LocalEnvironment/TCPIP/Receive/ConnectionDetails/Hostname | Der Hostname für die Herstellung einer Verbindung |
$LocalEnvironment/TCPIP/Receive/ConnectionDetails/Port | Die Portnummer für die Herstellung einer Verbindung |
$LocalEnvironment/TCPIP/Receive/ConnectionDetails/OpenTimestamp | Die Zeitmarke für die erste Öffnung der Verbindung |
$LocalEnvironment/TCPIP/Receive/ConnectionDetails/CloseTimestamp | Die Zeitmarke für das Schließen der Verbindung (null, wenn noch nicht geschlossen) |
$LocalEnvironment/TCPIP/Receive/ConnectionDetails/SequenceNumber/InputRecord | Die Folgenummer der Nachricht, die an dieser Verbindung empfangen wird. Der erste Datensatz hat die Folgenummer 1, der zweite Datensatz die Folgenummer 2 usw. |
$LocalEnvironment/TCPIP/Receive/ConnectionDetails/SequenceNumber/OutputRecord | Die Folgenummer der in dieser Verbindung gesendeten Nachricht. Der erste Datensatz hat die Folgenummer 1, der zweite Datensatz die Folgenummer 2 usw. |
$LocalEnvironment/TCPIP/Receive/ConnectionDetails/Id | Die ID des verwendeten Sockets. Diese ID ist eine interne Kennung, die von WebSphere Message Broker zur eindeutigen Identifizierung einer Verbindung verwendet wird. |
$LocalEnvironment/TCPIP/Receive/ConnectionDetails/ReplyId | Die Antwort-ID, die für diese Verbindung gespeichert ist. Diese ID kann eine beliebige Textzeichenfolge sein. |
Der TCPIPClientReceive-Knoten befindet sich im Ablagefach TCP/IP der Palette und wird im WebSphere Message Broker Toolkit durch folgendes Symbol dargestellt:
Informationen zu Beispielen können nur bei Verwendung des in das WebSphere Message Broker Toolkit integrierten bzw. online verfügbaren Information Center angezeigt werden. Muster können nur ausgeführt werden, wenn das im WebSphere Message Broker Toolkit integrierte Information Center verwendet wird.
Nachdem Sie eine Instanz des TCPIPClientReceive-Knotens in einen Nachrichtenfluss eingereiht haben, können Sie den Knoten konfigurieren; siehe Nachrichtenflussknoten konfigurieren. Die Knoteneigenschaften werden in der Eigenschaftenansicht angezeigt.
Alle verbindlichen Eigenschaften, für die kein Standardwert definiert ist, sind mit einem Stern markiert.
Konfigurieren Sie den TCPIPClientReceive-Knoten:
<mcd><Msd>MRM</Msd><Set>DHM4UO906S001</Set><Type>receiptmsg1</Type>
<Fmt>XML</Fmt></mcd>
Wenn Sie Werte festlegen, die sich von denen im MQRFH2-Header unterscheiden, haben die Werte im MQRFH2-Header Vorrang.
Wenn Sie Datensatzerkennung auf Verbindung geschlossen, Feste Länge oder Mit Begrenzer setzen, gilt für die Datensätze eine Längenbeschränkung von 100 MB. Wenn Sie Datensatzerkennung auf Syntaktisch analysierte Folge setzen, führt der TCPIPClientReceive-Knoten keine Ermittlung der Datensatzlänge durch und begrenzt diese auch nicht. Die im Nachrichtenfluss nachgeordneten Knoten können die Datensatzlänge entweder ermitteln oder lange Datensätze verarbeiten. Wenn lange Datensätze auf diese Weise verarbeitet werden sollen, müssen Sie sicherstellen, dass Ihr Broker über ausreichend Arbeitsspeicher verfügt. Um den verfügbaren Speicher optimal zu nutzen, müssen möglicherweise die im Beispiel für umfangreiche Nachrichtenausgaben beschriebenen Nachrichtenflusstechniken angewandt werden.
In der folgenden Tabelle werden die Terminals des TCPIPClientReceive-Knotens beschrieben.
Terminal | Beschreibung |
---|---|
Eingabeterminal (In) | Das Eingabeterminal, das eine Nachricht zur Verarbeitung durch einen Knoten annimmt |
Ausgabeterminal (Out) | Das Ausgabeterminal, an das die Nachricht geleitet wird, wenn sie erfolgreich von einer externen Ressource abgerufen wurde. Wenn im Empfangsknoten keine Fehler auftreten, wird eine von einer externen Ressource empfangene Nachricht immer zuerst an das Ausgangsterminal gesendet. |
Timeout | Das Terminal, an das eine Nachricht gesendet wird, wenn die in der Eigenschaft Zeitlimitüberschreitung bei Warten auf Datensatz angegebene Zeitspanne überschritten wurde. Der Nachrichtentext lautet Zeitlimitwert wurde überschritten. |
Fehlerterminal (Failure) | Das Ausgabeterminal, an das die Nachricht geleitet wird, wenn ein Fehler auftritt.Dazu gehören auch Fehler, die durch die Wiederholungsverarbeitung verursacht werden. Selbst wenn die Eigenschaft 'Auswerten' festgelegt wird, werden Nachrichten, die an dieses Terminal weitergegeben wurden, nicht ausgewertet.) |
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 Eigenschaften für die Beschreibung des TCPIPClientReceive-Knotens beschrieben.
Eigenschaft | O | K | Standardwert | Beschreibung |
---|---|---|---|---|
Knotenname | Nein | Nein | TCPIPClientReceive | Der Name des Knotens. |
Kurzbeschreibung | Nein | Nein | Kurze Beschreibung des Knotens. | |
Langbeschreibung | Nein | Nein | Text, der den Zweck des Knotens im Nachrichtenfluss beschreibt |
In der folgenden Tabelle werden die Basiseigenschaften des TCPIPClientReceive-Knotens beschrieben.
Eigenschaft | O | K | Standardwert | Beschreibung | Eigenschaft des Befehls mqsiapplybaroverride |
---|---|---|---|---|---|
Verbindungsdetails | Ja | Ja | Eine Zeichenfolge, die entweder den Hostnamen und die Portnummer, die verwendet werden sollen, oder den Namen eines konfigurierbaren Service angibt. | connectionDetails | |
Zeitlimitüberschreitung bei Warten auf Datensatz (Sekunden) | Ja | Ja | 60 | Gibt an, wie lange der Knoten an einer Verbindung auf weitere Daten wartet, nachdem das erste Datenbyte eingegangen ist. Sie können einen beliebigen Zeitwert in Sekunden angeben. | timeoutWaitingForData |
In der folgenden Tabelle werden die erweiterten Eigenschaften des TCPIPClientReceive-Knotens beschrieben.
Eigenschaft | O | K | Standardwert | Beschreibung |
---|---|---|---|---|
Verbindung schließen | Ja | Nein | Nein | Steuert, wann die Verbindung aufgehoben wird, oder ob sie geöffnet bleibt. Folgende Optionen sind gültig:
|
Eingabedatenstrom nach Empfang eines Datensatzes schließen | Ja | Nein | Nicht ausgewählt | Gibt an, ob der Eingabedatenstrom geschlossen werden soll, sobald die Daten abgerufen wurden. Wenn der Eingabedatenstrom der Verbindung reserviert ist, kann er ohne Kenntnis der ID von keinem anderen Knoten verwendet werden. Diese Eigenschaft ist standardmäßig nicht ausgewählt. |
Änderung Eingabedatenstrom | Nein | Nein | Unverändert lassen | Gibt an, ob der Eingabedatenstrom für die Verwendung durch Eingangs- und
Empfangsknoten, die eine Verbindungs-ID angeben, reserviert werden soll oder ob der Datenstrom am
Ende des Flusses freigegeben werden soll. Folgende Optionen sind gültig:
|
Änderung Ausgabedatenstrom | Nein | Nein | Unverändert lassen | Gibt an, ob dieser Ausgabedatenstrom reserviert oder freigegeben und zur Nutzung durch andere Sendeknoten an den Pool zurückgegeben wird.
Folgende Optionen sind gültig:
|
In der folgenden Tabelle werden die Anforderungseigenschaften des TCPIPClientReceive-Knotens beschrieben:
Eigenschaft | O | K | Standardwert | Beschreibung |
---|---|---|---|---|
Position des Hostnamens | Ja | Nein | $LocalEnvironment/TCPIP/Receive/Hostname | Die Position des Nachrichtenelements, die den Hostnamen enthält. |
Position des Ports | Ja | Nein | $LocalEnvironment/TCPIP/Receive/Port | Die Position des Nachrichtenelements, die den Port enthält. |
Position für ID | Ja | Nein | $LocalEnvironment//TCPIP/Receive/Id | Die Position des Nachrichtenelements, die die ID enthält. |
Position für Antwort-ID | Ja | Nein | $LocalEnvironment/TCPIP/Receive/ReplyId | Die Position des Nachrichtenelements, die die Antwort-ID enthält. |
Position der Datensatzlänge | Nein | Nein | $LocalEnvironment/TCPIP/Receive/Length | Die Position des Nachrichtenelements, welche die zu lesende Datensatzlänge enthält. Geben Sie auf der Registerkarte Datensätze und Elemente die Position des Werts an, der die Eigenschaft Länge (Bytes) außer Kraft setzen soll. Wenn Sie keinen Standort angeben, lautet der Standardwert $LocalEnvironment/TCPIP/Receive/Length. |
In der folgenden Tabelle werden die Ergebniseigenschaften des TCPIPClientReceive-Knotens beschrieben:
Eigenschaft | O | K | Standardwert | Beschreibung |
---|---|---|---|---|
Position für Ausgabedaten | Nein | Nein | $OutputRoot | Die Startposition innerhalb der Ausgabenachrichtenbaumstruktur, an der die
analysierten Elemente aus der Bitfolge der Nachricht gespeichert werden. Weitere Informationen hierzu finden Sie unter Ergebnisnachricht mit einer eingehenden Nachricht kombinieren. |
Lokale Umgebung kopieren | Nein | Nein | Ausgewählt | Gibt an, ob die lokale Umgebung in die Ausgabenachricht kopiert wird. |
In der folgenden Tabelle werden die Eigenschaften von 'Syntaxanalyse der Eingabenachricht' des TCPIPClientReceive-Knotens beschrieben.
Eigenschaft | O | K | Standardwert | Beschreibung | Eigenschaft des Befehls mqsiapplybaroverride |
---|---|---|---|---|---|
Nachrichtendomäne | Nein | Nein | BLOB (Binary large object) | Die Domäne für die Syntaxanalyse der eingehenden Nachricht. | |
Nachrichtenmodell | Nein | Nein | Der Name oder die Position des Nachrichtenmodells, in dem die eingehende Nachricht definiert ist. | ||
Nachricht | Nein | Nein | Der Name bzw. die Position eines globalen Elements, das ein gesamtes Datendokument modelliert und in der Schemadatei des Nachrichtenmodells enthalten ist. Diese Liste wird mit allen verfügbaren Nachrichten gefüllt, die in dem von Ihnen ausgewählten Nachrichtenmodell definiert sind. | ||
Physisches Format | Nein | Nein | Der Name des physischen Formats der eingehenden Nachricht. | ||
ID des codierten Nachrichtenzeichensatzes | Ja | Nein | Systemstandardwert des Brokers | Die ID des codierten Zeichensatzes, anhand dessen die gerade gelesenen Daten interpretiert werden. | messageCodedCharSetIdProperty |
Nachrichtverschlüsselung | Ja | Nein | Ermitteltes Brokersystem | Das Codeumsetzungsschema für Zahlen und umfangreiche Zeichen, anhand dessen die gerade gelesenen Daten interpretiert werden. Gültige Werte sind Ermitteltes Brokersystem oder ein numerischer Codierungswert. Weitere Informationen zur Codierung finden Sie unter Datenkonvertierung. | messageEncodingProperty |
In der folgenden Tabelle werden die Eigenschaften der Parser-Optionen für den TCPIPClientReceive-Knoten beschrieben.
Eigenschaft | O | K | Standardwert | Beschreibung |
---|---|---|---|---|
Zeitpunkt für Syntaxanalyse | Nein | Nein | Bei Bedarf | Durch diese Eigenschaft wird gesteuert, zu welchem Zeitpunkt eine Eingabenachricht syntaktisch analysiert wird. Gültige Werte sind:
Eine vollständige Beschreibung dieser Eigenschaft finden Sie unter Bedarfsgerechte Syntaxanalyse. |
Baumstruktur unter Verwendung von XML-Schemadatentypen erstellen | Nein | Nein | Nicht ausgewählt | Durch diese Eigenschaft wird gesteuert, ob die Syntaxelemente in der Nachrichtenbaumstruktur Datentypen aus dem XML-Schema enthalten. |
XMLNSC-Kompaktparser für XMLNS-Domäne verwenden | Nein | Nein | Nicht ausgewählt | Über diese Eigenschaft wird gesteuert, ob der XMLNSC-Kompaktparser für Nachrichten in der XMLNS-Domäne verwendet wird. Wenn Sie diese Eigenschaft feslegen, werden die Nachrichtendaten in Knoten, die mit dem Ausgabeterminal verbunden sind, unter XMLNSC angezeigt, wenn es sich bei dem MQRFH2-Eingabeheader oder der Eigenschaft Nachrichtendomäne unter 'Syntaxanalyse der Eingabenachricht' um XMLNS handelt. |
Zugriff auf gemischten Inhalt | Nein | Nein | Nicht ausgewählt | Mit dieser Eigenschaft können Sie steuern, ob der XMLNSC-Parser Elemente in der Nachrichtenbaumstruktur erstellt, wenn er gemischten Text in einer Eingabenachricht feststellt. Wenn Sie das Kontrollkästchen aktivieren, werden Elemente für gemischten Text erstellt. Andernfalls wird gemischter Text ignoriert, und es werden keine Elemente erstellt. |
Kommentare beibehalten | Nein | Nein | Nicht ausgewählt | Mit dieser Eigenschaft können Sie steuern, ob der XMLNSC-Parser Elemente in der Nachrichtenbaumstruktur erstellt, wenn er Kommentare in einer Eingabenachricht feststellt. Wenn Sie das Kontrollkästchen aktivieren, werden Elemente für Kommentare erstellt. Andernfalls werden Kommentare ignoriert und es werden keine Elemente erstellt. |
Verarbeitungsanweisung beibehalten | Nein | Nein | Nicht ausgewählt | Mit dieser Eigenschaft können Sie steuern, ob der XMLNSC-Parser Elemente in der Nachrichtenbaumstruktur erstellt, wenn er Verarbeitungsanweisungen in einer Eingabenachricht feststellt. Wenn Sie das Kontrollkästchen aktivieren, werden Elemente für Verarbeitungsanweisungen erstellt. Andernfalls werden Verarbeitungsanweisungen ignoriert und es werden keine Elemente erstellt. |
Nicht transparente Elemente | Nein | Nein | Leer | Über diese Eigenschaft wird eine Liste von Elementen in der Eingabenachricht angegeben, die vom XMLNSC-Parser nicht transparent analysiert werden sollen. |
In der folgenden Tabelle werden die Datensatz- und Elementeigenschaften des TCPIPClientReceive-Knotens beschrieben:
Eigenschaft | O | K | Standardwert | Beschreibung |
---|---|---|---|---|
Datensatzerkennung | Ja | Nein | Verbindung geschlossen | Der Mechanismus zur Identifikation von Datensätzen in der Eingabedatei. Folgende Optionen sind gültig:
|
Länge (Bytes) | Ja | Nein | 0 | Die Länge der einzelnen Datensätze in Bytes, wenn die Datensatzerkennung Feste Länge ausgewählt ist. |
Begrenzer | Ja | Nein | DOS- oder UNIX-Linienende | Die Art der Begrenzerbytes, mit denen die einzelnen Datensätze getrennt oder
beendet werden, wenn die Datensatzerkennung Mit
Begrenzer ausgewählt ist. Folgende Optionen sind gültig:
|
Angepasster Begrenzer (hexadezimal) | Nein | Nein | Die hexadezimal ausgedrückten Begrenzerbytes, wenn die Datensatzerkennung Mit Begrenzer und Angepasster Begrenzer (hexadezimal) ausgewählt sind. Diese Eigenschaft ist nur obligatorisch, wenn die Eigenschaft Begrenzer auf Angepasster Begrenzer (hexadezimal) gesetzt ist. | |
Begrenzertyp | Ja | Nein | Postfix | Die Position des Begrenzers, wenn die Datensatzerkennung
Mit Begrenzer und
Angepasster Begrenzer (hexadezimal) ausgewählt sind. Folgende Optionen sind gültig:
|
In der folgenden Tabelle werden die Auswertungseigenschaften des TCPIPClientReceive-Knotens beschrieben.
Eine umfassende Beschreibung dieser Eigenschaften finden Sie unter Auswertungseigenschaften.
Eigenschaft | O | K | Standardwert | Beschreibung | Eigenschaft des Befehls mqsiapplybaroverride |
---|---|---|---|---|---|
Auswertung | Nein | Ja | Ohne | Durch diese Eigenschaft wird gesteuert, ob eine Auswertung stattfindet. Gültige Werte sind:
|
validateMaster |
Fehlerbehebungsmaßnahme | Nein | Nein | Ausnahme | Durch diese Eigenschaft wird gesteuert, was beim Fehlschlagen der Auswertung
geschieht. Diese Eigenschaft kann nur angegeben werden, wenn Auswerten auf Inhalt oder Inhalt und Wert gesetzt ist. Gültige Werte sind:
|
Eigenschaft | O | K | Standardwert | Beschreibung |
---|---|---|---|---|
Ereignisse | Nein | Nein | Ohne | Auf dieser Registerkarte werden Ereignisse angezeigt, die Sie für den Knoten
definiert haben. Standardmäßig sind für keinen Knoten in einem Nachrichtenfluss
Überwachungsereignisse definiert. Über Hinzufügen,
Bearbeiten und Löschen können Sie
Überwachungsereignisse für den Knoten erstellen, ändern oder löschen (Details siehe
Überwachungsereignisquellen mithilfe von Überwachungseigenschaften konfigurieren). Sie können hier angezeigte Ereignisse aktivieren oder inaktivieren, indem Sie das Kontrollkästchen Aktiviert aktivieren oder inaktivieren. |