WebSphere Message Broker Version 8.0.0.5 Betriebssysteme: AIX, HP-Itanium, Linux, Solaris, Windows, z/OS

Sehen Sie sich die Informationen zur aktuellen Produktversion im IBM Integration Bus Version 9.0 an.

TCPIPServerReceive-Knoten

Mithilfe des TCPIPServerReceive-Knotens können Sie Daten über eine TCP/IP-Serververbindung empfangen.

Dieses Thema ist in folgende Abschnitte eingeteilt:

Zweck

Der TCPIPServerReceive-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.

Sobald eine Verbindung hergestellt wurde, werden die Daten an den TCPIPServerReceive-Knoten gesendet. Wenn der TCPIPServerReceive-Knoten nicht alle Daten innerhalb der Zeitspanne empfangen kann, die in der Eigenschaft Zeitlimitüberschreitung bei Warten auf Datensatz (Sekunden) angegeben ist, wird die Nachricht an das Timeout-Terminal gesendet; wenn kein Timeout-Terminal verbunden ist, 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.

Die Eigenschaften in der lokalen Umgebung können die vom Knoten verwendete TCP/IP-Verbindung überschreiben.

Tabelle 1. Eingabeeigenschaften der lokalen Umgebung
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-Serververbindung 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 angezeigt werden. Auf diese Weise 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 Baumstruktur der lokalen Umgebung mit den Details der verwendeten Verbindung gefüllt.

Tabelle 2. Ausgabeeigenschaften der lokalen Umgebung
Position in der lokalen Umgebung für die Ausgabe vom Knoten Beschreibung
$LocalEnvironment/TCPIP/Receive/ConnectionDetails/Type Der Server
$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 Nachricht, die auf dieser Verbindung gesendet wird. 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. Hierbei kann es sich um eine beliebige Zeichenfolge handeln.
$LocalEnvironment/TCPIP/Receive/ConnectionDetails/ClientDetails/Hostname Der vollständig qualifizierte Domänenname des Computers, über den der Client verbunden ist.
$LocalEnvironment/TCPIP/Receive/ConnectionDetails/ClientDetails/Address Die IP-Adresse des Computers, über den der Client verbunden ist.

Der TCPIPServerReceive-Knoten befindet sich im Ablagefach TCP/IP der Palette und wird im WebSphere Message Broker Toolkit durch folgendes Symbol dargestellt:

Symbol für TCPIPServerReceive-Knoten

Nachrichtenstruktur

Der TCPIPServerReceive-Knoten bearbeitet Nachrichten in den folgenden Nachrichtendomänen:
  • DFDL
  • XMLNSC
  • DataObject
  • JSON
  • BLOB
  • MIME
  • MRM
  • JMSMap
  • JMSStream
  • XMLNS

TCPIPServerReceive-Knoten in einem Nachrichtenfluss verwenden

In den folgenden Beispielen wird die Verwendung des TCPIPServerReceive-Knotens erläutert:

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.

Den TCPIPServerReceive-Knoten konfigurieren

Nachdem Sie eine Instanz des TCPIPServerReceive-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 TCPIPServerReceive-Knoten:

  1. Optional: Geben Sie auf der Registerkarte Beschreibung eine Kurzbeschreibung und/oder eine Ausführliche Beschreibung ein. Sie können den Knoten dort auch umbenennen.
  2. Legen Sie auf der Registerkarte Grundeinstellung die Eigenschaften fest, die bestimmen, wie die TCP/IP-Verbindung gesteuert wird.
    • Mit der Eigenschaft Verbindungsdetails können Sie den Hostnamen und die Portnummer, die verwendet werden sollen, oder den Namen eines konfigurierbaren Service festlegen. Diese Eigenschaft muss angegeben werden. Folgende Formate werden unterstützt:
      • Konfigurierbarer Servicename. Dieser Wert wird für die Suche nach dem Port und Hostnamen in konfigurierbaren Services verwendet. Beispiel: TCPIPProfile1.
      • <Hostname>:<Port>. Dieser Wert ist der Hostname gefolgt von der Portnummer (getrennt durch einen Doppelpunkt). Beispiel: tcpip.server.com:1111
      • <Port>. Dieser Wert ist die Portnummer. In diesem Fall wird davon ausgegangen, dass der Hostname localhost lautet.
    • Mit der Eigenschaft Zeitlimitüberschreitung bei Warten auf Datensatz (Sekunden) können Sie festlegen, 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. Der Standardwert beträgt 60 Sekunden. Sobald die festgelegte Zeitspanne überschritten ist, werden alle verfügbaren Daten an das Fehlerterminal (Failure) gesendet.
  3. Legen Sie auf der Registerkarte Erweitert die Eigenschaften fest, die bestimmen, wie der Datenstrom gesteuert wird.
    • Geben Sie mit der Eigenschaft Verbindung schließen an, wann und wie die Verbindung aufgehoben werden soll.
      • Wählen Sie Nein aus, wenn die Verbindung geöffnet bleiben soll. Dies ist die Standardeinstellung.
      • Wählen Sie Nach Zeitlimitüberschreitung aus, wenn die Verbindung beim Auftreten einer Zeitlimitüberschreitung aufgehoben werden soll.
      • Wählen Sie Nachdem Daten empfangen wurden aus, wenn die Verbindung aufgehoben werden soll, sobald das Ende des Datensatzes festgestellt wird.
    • Wählen Sie Eingabedatenstrom nach Empfang eines Datensatzes schließen aus, wenn der Eingabedatenstrom geschlossen werden soll, sobald die Daten abgerufen wurden. Diese Eigenschaft ist standardmäßig nicht ausgewählt. Wenn der Eingabedatenstrom der Verbindung reserviert ist, kann er ohne Kenntnis der ID von keinem anderen Knoten verwendet werden.
    • Die Option Änderung Eingabedatenstrom gibt an, ob der Eingabedatenstrom für die Verwendung durch Eingangs- und Empfangsknoten, die eine Verbindungs-ID angeben, reserviert werden soll oder ob der Eingabedatenstrom am Ende des Flusses freigegeben werden soll.
      • Wählen Sie Unverändert lassen aus, wenn Sie den Eingabedatenstrom genau so übernehmen möchten, wie er beim Eintritt in den Knoten vorgefunden wurde. Dieser Wert ist standardmäßig ausgewählt.
      • Wählen Sie Eingabedatenstrom freigeben aus, um festzulegen, dass dieser Eingabedatenstrom an den Pool zurückgegeben und Eingabe- oder Empfangsknoten zur Nutzung zur Verfügung stehen soll.
      • Wählen Sie Eingabedatenstrom reservieren (für Nutzung durch künftige TCP/IP-Knoten) aus, um festzulegen, dass dieser Eingabedatenstrom nur von diesem Knoten und von anderen Eingabe- oder Empfangsknoten, die ihn unter Angabe der Verbindungs-ID anfordern, verwendet werden kann. Wenn der Eingabedatenstrom der Verbindung reserviert ist, kann er ohne Angabe der richtigen Verbindungs-ID von keinem anderen Knoten verwendet werden.
      • Wählen Sie Eingabedatenstrom reservieren (für Nutzung durch künftige TCP/IP-Knoten), dann nach Weitergabe freigeben aus, um festzulegen, dass dieser Eingabedatenstrom nur von diesem Knoten und von Empfangsknoten, die ihn unter Angabe der korrekten Verbindungs-ID anfordern, verwendet werden kann. Sobald die Nachricht weitergegeben wurde, wird dieser Eingabedatenstrom an den Pool zurückgegeben und steht anderen Eingabe- oder Empfangsknoten zur Nutzung zur Verfügung.
    • Mit der Eigenschaft Änderung Ausgabedatenstrom können Sie festlegen, ob der Ausgabedatenstrom reserviert oder freigegeben werden soll. Diese Optionen sind nur verfügbar, wenn Sie die Eigenschaft Ausgabedatenstrom nach Senden eines Datensatzes schließen nicht ausgewählt haben.
      • Wählen Sie Unverändert lassen aus, wenn Sie den Ausgabedatenstrom genau so übernehmen möchten, wie er beim Eintritt in den Knoten vorgefunden wurde. Dieser Wert ist standardmäßig ausgewählt.
      • Wählen Sie Ausgabedatenstrom freigeben aus, um festzulegen, dass dieser Ausgabedatenstrom an den Pool zurückgegeben und anderen Sendeknoten zur Nutzung zur Verfügung stehen soll.
      • Wählen Sie Ausgabedatenstrom reservieren (für Nutzung durch künftige TCP/IP-Knoten) aus, um festzulegen, dass dieser Ausgabedatenstrom nur von diesem Knoten und von anderen Sendeknoten, die ihn unter Angabe der Verbindungs-ID anfordern, verwendet werden kann. Wenn der Eingabedatenstrom der Verbindung reserviert ist, kann er ohne Angabe der richtigen Verbindungs-ID von keinem anderen Knoten verwendet werden.
      • Wählen Sie Ausgabedatenstrom reservieren (für Nutzung durch künftige TCP/IP-Knoten), dann nach Weitergabe freigeben aus, um festzulegen, dass dieser Ausgabedatenstrom nur von diesem Knoten und von Sendeknoten, die ihn unter Angabe der korrekten Verbindungs-ID anfordern, verwendet werden kann. Sobald die Nachricht weitergegeben wurde, wird dieser Ausgabedatenstrom an den Pool zurückgegeben und steht anderen Sendeknoten zur Nutzung zur Verfügung.
  4. Geben Sie auf der Registerkarte Anforderung den Standort der zu schreibenden Daten an. Die Eigenschaften dieser Registerkarte können Sie als XPath- oder ESQL-Ausdrücke angeben. In der Ansicht 'Eigenschaften' und auch im Erstellungsprogramm für XPath-Ausdrücke stehen Inhaltshilfen zur Verfügung, die Sie durch Klicken auf Bearbeiten rechts neben den einzelnen Eigenschaften aufrufen können.
    • Geben Sie unter Position für Hostname die Position des Werts an, mit dem der Wert für Hostname in der Eigenschaft Verbindungsdetails auf der Registerkarte Grundeinstellung überschrieben werden soll. Wenn Sie keinen Standort angeben, lautet der Standardwert $LocalEnvironment/TCPIP/Receive/Hostname.
    • Geben Sie unter Position für Port die Position des Werts an, mit dem der Wert für Portnummer in der Eigenschaft Verbindungsdetails auf der Registerkarte Grundeinstellung überschrieben werden soll. Wenn Sie keinen Standort angeben, lautet der Standardwert $LocalEnvironment/TCPIP/Receive/Port.
    • Geben Sie unter Position für ID die Position der ID des verwendeten Sockets an. Diese interne Kennung wird von WebSphere Message Broker zur eindeutigen Identifizierung einer Verbindung verwendet. Wenn Sie keinen Standort angeben, lautet der Standardwert $LocalEnvironment/TCPIP/Receive/Id.
    • Geben Sie unter Position für Antwort-ID die Position der Antwort-ID an, die für die verwendete Verbindung gespeichert ist. Die Antwort-ID kann bei der Rückgabe von Daten in einem Empfangsknoten verwendet werden. Wenn Sie keinen Standort angeben, lautet der Standardwert $LocalEnvironment/TCPIP/Receive/ReplyId.
  5. Legen Sie auf der Registerkarte Ergebnis Werte für die Eigenschaften fest, die bestimmen, wo die Antwort gespeichert wird.
    • Mit der Eigenschaft Position für Ausgabedaten können Sie die Startposition innerhalb der Ausgabenachrichtenbaumstruktur festlegen, an der die analysierten Elemente aus der Bitfolge der Nachricht gespeichert werden. Der Standardwert ist $OutputRoot.
    • Mit der Eigenschaft Lokale Umgebung kopieren können Sie angeben, ob die lokale Umgebung in die Ausgabenachricht kopiert werden soll.
      • Wenn Lokale Umgebung kopieren ausgewählt ist, wird eine neue Kopie der lokalen Umgebung in der Baumstruktur erstellt. Diese Kopie wird mit dem Inhalt der lokalen Umgebung des vorangegangenen Knotens gefüllt. Wenn die lokale Umgebung eines Knotens geändert wird, wirken sich diese Änderungen nicht auf die vorgeordneten Knoten aus, weil sie jeweils über eine eigene Kopie verfügen. Dies ist die Standardeinstellung.
      • Wird Lokale Umgebung kopieren nicht ausgewählt, erstellt der Knoten keine eigene Kopie der lokalen Umgebung, sondern verwendet die lokale Umgebung, die vom vorherigen Knoten übergeben wird. Wenn die lokale Umgebung eines Knotens geändert wird, werden die Änderungen auch von den vorgeordneten Knoten übernommen.
  6. Legen Sie auf der Registerkarte Syntaxanalyse der Eingabenachricht Werte für die Eigenschaften fest, anhand derer der Knoten feststellt, wie die eingehende Nachricht analysiert werden soll.
    Umfasst die eingehende Nachricht einen MQRFH2-Header, müssen für die Eigenschaften unter 'Syntaxanalyse der Eingabenachricht' keien Werte definiert werden, da die Werte aus dem Ordner <mcd> im MQRFH2-Header abgeleitet werden, z. B.:
    <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.

    • Wählen Sie aus der Liste unter Nachrichtendomäne den Namen des von Ihnen verwendeten Parsers aus. Der Standardwert ist BLOB. Sie können eine der folgenden Optionen auswählen:
      • DFDL
      • XMLNSC
      • DataObject
      • JSON
      • BLOB
      • MIME
      • MRM
      • JMSMap
      • JMSStream
      • XMLNS
      Sie können bei Bedarf auch einen benutzerdefinierten Parser angeben.
    • Wenn Sie den DFDL-, den MRM- oder den XMLNSC-Parser im Prüfungsmodus verwenden, wählen Sie das relevante Nachrichtenmodell aus der Liste aus. Diese Liste wird mit den verfügbaren Nachrichtengruppen gefüllt, wenn Sie MRM oder XMLNSC als Nachrichtendomäne auswählen, bzw. mit den verfügbaren DFDL-Schemadateien, wenn Sie DFDL als Nachrichtendomäne auswählen.
    • Wenn Sie den DFDL- oder den MRM-Parser verwenden, wählen Sie die korrekte Nachricht aus der Liste Nachricht aus. Diese Liste wird mit den im ausgewählten Nachrichtenmodell definierten Nachrichten gefüllt.
    • Wenn Sie den MRM-Parser verwenden, wählen Sie das Format der Nachricht aus der Liste Physisches Format aus. Diese Liste enthält alle für dieses Nachrichtenmodell definierten physischen Formate.
    • Geben Sie in ID der codierten Nachrichtengruppe die ID der codierten Nachrichtengruppe an.
    • Wählen Sie aus der Liste unter Nachrichtencodierung die Nachrichtencodierung aus, oder geben Sie einen numerischen Codierungswert ein. Weitere Informationen zur Codierung finden Sie unter Datenkonvertierung.
  7. Auf der untergeordneten Registerkarte Parser-Optionen:
    • Die Option Zeitpunkt für Syntaxanalyse ist standardmäßig auf Bei Bedarf gesetzt. Dies führt dazu, dass die Syntaxanalyse der Nachricht verzögert wird. Der Abschnitt Bedarfsgerechte Syntaxanalyse enthält Informationen zur sofortigen Analyse von Nachrichten.
    • Wenn Sie den XMLNSC-Parser verwenden, legen Sie die Werte für die Eigenschaften fest, die bestimmen, wie der XMLNSC-Parser vorgeht. Weitere Informationen hierzu finden Sie im Abschnitt Nachrichten in der XMLNSC-Domäne bearbeiten.
  8. Geben Sie auf der Registerkarte Datensätze und Elemente an, wie die Daten als Datensätze interpretiert werden. Bei jedem Start des TCPIPServerReceive-Knotens wird immer nur ein Datensatz abgerufen. Umfasst der TCP/IP-Datenstrom mehrere logische Nachrichten, muss der Knoten folglich mehrmals gestartet werden, damit alle Nachrichten empfangen werden können.
    • Geben Sie mit der Eigenschaft Datensatzerkennung an, wie die Daten in Datensätze aufgeteilt wird, aus denen dann die einzelnen Nachrichten generiert werden. Folgende Optionen stehen zur Auswahl:
      • Verbindung geschlossen gibt an, dass es sich bei allen während einer bestehenden Verbindung gesendeten Daten um einen einzelnen Datensatz handelt.
      • Feste Länge - jeder Datensatz umfasst eine festgelegte Anzahl Bytes. Jeder Datensatz enthält die in der Eigenschaft Länge angegebene Bytezahl, lediglich der letzte Datensatz in der Datei kann möglicherweise kürzer sein.
      • Wählen Sie Mit Begrenzer aus, wenn die verarbeiteten Datensätze durch ein DOS- oder UNIX-Zeilenende bzw. durch eine Folge benutzerdefinierter Begrenzerbytes getrennt bzw. beendet werden. Geben Sie für die Eigenschaften Begrenzer und Begrenzertyp den Begrenzer und den Begrenzertyp an.
      • Wählen Sie die Option Syntaktisch analysierte Folge aus, wenn die Daten eine Folge von einem oder mehreren Datensätzen enthält, die von dem unter Nachrichtendomäne angegebenen Parser seriell erkannt werden. Die einzelnen erkannten Datensätze werden vom Knoten jeweils als separate Nachrichten weitergegeben. Bei Auswahl der Option Datensatzerkennung muss unter Nachrichtendomäne entweder ein XMLNSC- oder ein MRM-Parser angegeben sein (das physische Format muss CWF oder TDS sein).
    • Wenn Sie Datensatzerkennung auf Feste Länge gesetzt haben, geben Sie als Länge die erforderliche Länge des Ausgabesatzes an. Dieser Wert muss zwischen 1 Byte und 100 MB liegen. Der Standardwert beträgt 80 Bytes.

      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 TCPIPServerReceive-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ügaren Speicher optimal zu nutzen, müssen möglicherweise die im Beispiel für umfangreiche Nachrichtenausgaben beschriebenen Nachrichtenflusstechniken angewandt werden.

    • Wenn Sie Datensatzerkennung auf Mit Begrenzer setzen, müssen Sie als Begrenzer den zu verwendenden Begrenzer angeben. Folgende Optionen stehen zur Auswahl:
      • DOS- oder UNIX-Zeilenende gibt auf UNIX-Systemen das Zeilenvorschubzeichen (<LF>, X'0A') und auf Windows-Systemen ein Rücklaufzeichen gefolgt von einem Zeilenvorschubzeichen (<CR><LF>, X'0D0A') an. Der Knoten behandelt beide Zeichenfolgen als Begrenzer, unabhängig davon, auf welchem System der Broker ausgeführt wird. Falls beide Zeichenfolgen im gleichen Datensatz angezeigt werden, erkennt der Knoten beide als Begrenzer. X'15' wird vom Knoten hingegen nicht erkannt. Diese Zeichenfolge steht auf z/OS-Systemen für das Neue-Zeile-Byte. Wenn die Eingabedatei mit der EBCDIC-Zeichenfolge für neue Zeilen codiert ist, setzen Sie diese Eigenschaft auf Angepasster Begrenzer und setzen Sie Angepasster Begrenzer auf 15 angeben.
      • Angepasster Begrenzer (hexadezimal): Hier können Sie für Angepasster Begrenzer (hexadezimal) eine Bytefolge angeben.
    • Geben Sie unter Angepasster Begrenzer (hexadezimal) den Begrenzer (ein Byte oder mehrere Bytes) an, der verwendet werden soll, wenn die Eigenschaft Begrenzer auf Angepasster Begrenzer (hexadezimal) gesetzt ist. Geben Sie diesen Wert als geradzahlige Zeichenfolge mit Hexadezimalziffern an. Der Standardwert ist X'0A', die maximale Länge der Zeichenfolge beträgt 16 Bytes (dargestellt durch 32 Hexadezimalziffern).
    • Wenn Sie Datensatzerkennung auf Mit Begrenzer setzen, müssen Sie als Begrenzertyp den zu verwendenden Begrenzertyp angeben. Gültige Werte sind:
      • Infix. Bei Auswahl dieses Werts wird jeder Begrenzer zum Trennen von Datensätzen eingesetzt. Wenn die Daten mit einem Begrenzer enden, werden die Daten (der Länge null) nach dem letzten Begrenzer ebenfalls weitergegeben, obwohl keine Daten enthalten sind.
      • Postfix. Bei Angabe dieses Werts wird jeder Begrenzer zum Beenden von Datensätzen eingesetzt. Wenn die Daten mit einem Begrenzer enden, wird kein leerer Datensatz nach dem Begrenzer weitergegeben. Enden die Daten nicht mit einem Begrenzer, werden sie genauso verarbeitet, als ob den letzten Bytes der Daten ein Begrenzer folgen würde. Postfix ist der Standardwert.
    • Der TCPIPServerReceive-Knoten sieht jedes Vorkommen des Begrenzers in der Eingabe als trennenden Begrenzer (Infix) oder beendenden Begrenzer (Postfix) für die einzelnen Datensätze an. Wenn die Daten mit einem Begrenzer beginnen, behandelt der Knoten den Inhalt (der Länge null) vor diesem Begrenzer als Datensatz und gibt somit einen leeren Datensatz an den Fluss weiter. Der Begrenzer wird niemals in die weitergegebene Nachricht aufgenommen.
  9. Nehmen Sie über die Registerkarte Auswertung eine Auswertung anhand der Nachrichtengruppe für vordefinierte Nachrichten vor. Weitere Informationen zur Auswertung finden Sie im Abschnitt Nachrichten überprüfen. Informationen zum Ausfüllen dieser Registerkarte finden Sie im Abschnitt Eigenschaften der Registerkarte 'Auswertung'.

Terminals und Eigenschaften

In der folgenden Tabelle werden die Terminals des TCPIPServerReceive-Knotens beschrieben.

Terminal Beschreibung
Eingabe Das Eingabeterminal, das eine Nachricht zur Verarbeitung durch einen Knoten annimmt
Ausgang Das Ausgabeterminal, an das die Nachricht geleitet wird, wenn sie erfolgreich von einer externen Ressource abgerufen wurde. Wenn keine Fehler im Eingabefluss auftreten, wird die von einer externen Ressource empfangene Nachricht immer zuerst an das Ausgabeterminal 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 TCPIPServerReceive-Knotens beschrieben.

Eigenschaft O K Standardwert Beschreibung
Knotenname Nein Nein TCPIPServerReceive Der Name des Knotens.
Kurzbeschreibung Nein Nein   Kurze Beschreibung des Knotens.
Langbeschreibung Nein Nein   Text, der den Zweck des Knotens im Nachrichtenfluss beschreibt

Die Basiseigenschaften des TCPIPServerReceive-Knotens bestimmen, wie die TCP/IP-Verbindung gesteuert wird, und werden in der folgenden Tabelle beschrieben.

Eigenschaft O K Standardwert Beschreibung Eigenschaft des Befehls mqsiapplybaroverride
Verbindungsdetails Ja Ja   Eine Zeichenfolge, die die Portnummer, die verwendet werden soll, oder den Namen eines konfigurierbaren Service enthält. Folgende Formate werden unterstützt:
  • Konfigurierbarer Servicename. Dieser Wert wird für die Suche nach dem Port und Hostnamen in konfigurierbaren Services verwendet. Beispiel: TCPIPProfile1.
  • <Port>. Dieser Wert ist die Portnummer; Beispiel: 1111
  • <Port>. Dieser Wert ist die Portnummer. In diesem Fall wird davon ausgegangen, dass der Hostname localhost lautet.
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. Der Standardwert beträgt 60 Sekunden. Sobald die festgelegte Zeitspanne überschritten ist, werden alle verfügbaren Daten an das Fehlerterminal (Failure) gesendet. timeoutWaitingForData

Die erweiterten Eigenschaften des TCPIPServerReceive-Knotens bestimmen, wie der Datenstrom gesteuert wird, und werden in der folgenden Tabelle 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:
  • Wählen Sie Nein aus, wenn die Verbindung geöffnet bleiben soll. Dies ist die Standardeinstellung.
  • Wählen Sie Nach Zeitlimitüberschreitung aus, wenn die Verbindung beim Auftreten einer Zeitlimitüberschreitung aufgehoben werden soll.
  • Wählen Sie Nachdem Daten empfangen wurden aus, wenn die Verbindung aufgehoben werden soll, sobald das Ende des Datensatzes festgestellt wird.
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:
  • Wählen Sie Unverändert lassen aus, wenn Sie den Eingabedatenstrom genau so übernehmen möchten, wie er beim Eintritt in den Knoten vorgefunden wurde. Dieser Wert ist standardmäßig ausgewählt.
  • Wählen Sie Eingabedatenstrom freigeben aus, um festzulegen, dass dieser Eingabedatenstrom an den Pool zurückgegeben und Eingabe- oder Empfangsknoten zur Nutzung zur Verfügung stehen soll.
  • Wählen Sie Eingabedatenstrom reservieren (für Nutzung durch künftige TCP/IP-Knoten) aus, um festzulegen, dass dieser Eingabedatenstrom nur von diesem Knoten und von anderen Eingabe- oder Empfangsknoten, die ihn unter Angabe der Verbindungs-ID anfordern, verwendet werden kann. Wenn der Eingabedatenstrom der Verbindung reserviert ist, kann er ohne Angabe der richtigen Verbindungs-ID von keinem anderen Knoten verwendet werden.
  • Wählen Sie Eingabedatenstrom reservieren (für Nutzung durch künftige TCP/IP-Knoten), dann nach Weitergabe freigeben aus, um festzulegen, dass dieser Eingabedatenstrom nur von diesem Knoten und von Empfangsknoten, die ihn unter Angabe der korrekten Verbindungs-ID anfordern, verwendet werden kann. Sobald die Nachricht weitergegeben wurde, wird dieser Eingabedatenstrom an den Pool zurückgegeben und steht anderen Eingabe- oder Empfangsknoten zur Nutzung zur Verfügung.
Ä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. Diese Optionen sind nur verfügbar, wenn Sie die Eigenschaft Ausgabedatenstrom nach Senden eines Datensatzes schließen nicht ausgewählt haben.
  • Wählen Sie Unverändert lassen aus, wenn Sie den Ausgabedatenstrom genau so übernehmen möchten, wie er beim Eintritt in den Knoten vorgefunden wurde. Dieser Wert ist standardmäßig ausgewählt.
  • Wählen Sie Ausgabedatenstrom freigeben aus, um festzulegen, dass dieser Ausgabedatenstrom an den Pool zurückgegeben und anderen Sendeknoten zur Nutzung zur Verfügung stehen soll.
  • Wählen Sie Ausgabedatenstrom reservieren (für Nutzung durch künftige TCP/IP-Knoten) aus, um festzulegen, dass dieser Ausgabedatenstrom nur von diesem Knoten und von anderen Sendeknoten, die ihn unter Angabe der Verbindungs-ID anfordern, verwendet werden kann. Wenn der Eingabedatenstrom der Verbindung reserviert ist, kann er ohne Angabe der richtigen Verbindungs-ID von keinem anderen Knoten verwendet werden.
  • Wählen Sie Ausgabedatenstrom reservieren (für Nutzung durch künftige TCP/IP-Knoten), dann nach Weitergabe freigeben aus, um festzulegen, dass dieser Ausgabedatenstrom nur von diesem Knoten und von Sendeknoten, die ihn unter Angabe der korrekten Verbindungs-ID anfordern, verwendet werden kann. Sobald die Nachricht weitergegeben wurde, wird dieser Ausgabedatenstrom an den Pool zurückgegeben und steht anderen Sendeknoten zur Nutzung zur Verfügung.

Die Anforderungseigenschaften des TCPIPServerReceive-Knotens geben die Position der zu schreibenden Daten an. Die Eigenschaften dieser Registerkarte können Sie als XPath- oder ESQL-Ausdrücke angeben. In der Ansicht 'Eigenschaften' und auch im Erstellungsprogramm für XPath-Ausdrücke stehen Inhaltshilfen zur Verfügung, die Sie durch Klicken auf Bearbeiten rechts neben den einzelnen Eigenschaften aufrufen können. Die Anforderungseigenschaften werden in der folgenden Tabelle beschrieben:

Eigenschaft O K Standardwert Beschreibung
Position des Ports Ja Nein $LocalEnvironment/TCPIP/Receive/Port Die Position des Nachrichtenelements, die den Port enthält. Geben Sie die Position des Werts an, mit dem der Wert für Portnummer in der Eigenschaft Verbindungsdetails auf der Registerkarte Grundeinstellung überschrieben werden soll. Wenn Sie keinen Standort angeben, lautet der Standardwert $LocalEnvironment/TCPIP/Receive/Port.
Position für ID Ja Nein $LocalEnvironment/TCPIP/Receive/Id Die Position des Nachrichtenelements, die die ID enthält. Geben Sie die Position der ID des verwendeten Sockets an. Diese interne Kennung wird von WebSphere Message Broker zur eindeutigen Identifizierung einer Verbindung verwendet. Wenn Sie keinen Standort angeben, lautet der Standardwert $LocalEnvironment/TCPIP/Receive/Id.
Position für Antwort-ID Ja Nein $LocalEnvironment/TCPIP/Receive/ReplyId Die Position des Nachrichtenelements, die die Antwort-ID enthält. Geben Sie die Position der Antwort-ID an, die in der verwendeten Verbindung gespeichert ist. Die Antwort-ID kann bei der Rückgabe von Daten in einem Empfangsknoten verwendet werden. Wenn Sie keinen Standort angeben, lautet der Standardwert $LocalEnvironment/TCPIP/Receive/ReplyId.
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.

Die Ergebniseigenschaften des TCPIPServerReceive-Knotens bestimmen, wo die Antwort gespeichert werden soll, und werden in der folgenden Tabelle 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.
  • Wenn Lokale Umgebung kopieren ausgewählt ist, wird eine neue Kopie der lokalen Umgebung in der Baumstruktur erstellt. Diese Kopie wird mit dem Inhalt der lokalen Umgebung des vorangegangenen Knotens gefüllt. Wenn die lokale Umgebung eines Knotens geändert wird, wirken sich diese Änderungen nicht auf die vorgeordneten Knoten aus, weil sie jeweils über eine eigene Kopie verfügen. Dies ist die Standardeinstellung.
  • Wird Lokale Umgebung kopieren nicht ausgewählt, erstellt der Knoten keine eigene Kopie der lokalen Umgebung, sondern verwendet die lokale Umgebung, die vom vorherigen Knoten übergeben wird. Wenn die lokale Umgebung eines Knotens geändert wird, werden die Änderungen auch von den vorgeordneten Knoten übernommen.

Die Eigenschaften für 'Syntaxanalyse der Eingabenachricht' des TCPIPServerReceive-Knotens bestimmen, wie die ankommende Nachricht analysiert werden soll.

Wenn die eingehende Nachricht einen MQRFH2-Header enthält, müssen Sie keine Werte für die Eigenschaften unter 'Syntaxanalyse der Eingabenachricht' angeben, da die Werte aus dem Ordner <mcd> im MQRFH2-Header abgeleitet werden, z. B.:
<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.

In der folgenden Tabelle werden die Eigenschaften von 'Syntaxanalyse der Eingabenachricht' des TCPIPServerReceive-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 TCPIPServerReceive-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:
  • Bei Bedarf
  • Sofort
  • Vollständig
Die Option Zeitpunkt für Syntaxanalyse ist standardmäßig auf Bei Bedarf gesetzt. Dies führt dazu, dass die Syntaxanalyse der Nachricht verzögert wird. Der Abschnitt Bedarfsgerechte Syntaxanalyse enthält Informationen zur sofortigen Analyse von Nachrichten.
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 Durch diese Eigenschaft wird gesteuert, ob der XMLNSC-Kompaktparser für Nachrichten in der XMLNS-Domäne verwendet wird. Wenn Sie diese Eigenschaft festlegen, 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.

Die Eigenschaften unter 'Datensätze und Elemente' der TCPIPServerReceive-Knotens geben an, wie die Daten als Datensätze interpretiert werden, und werden in der folgenden Tabelle beschrieben:

Eigenschaft O K Standardwert Beschreibung
Datensatzerkennung Ja Nein Verbindung geschlossen Der Mechanismus zur Identifikation von Datensätzen in der Eingabedatei.
  • Verbindung geschlossen gibt an, dass es sich bei allen während einer bestehenden Verbindung gesendeten Daten um einen einzelnen Datensatz handelt.
  • Feste Länge - jeder Datensatz umfasst eine festgelegte Anzahl Bytes. Jeder Datensatz enthält die in der Eigenschaft Länge angegebene Bytezahl, lediglich der letzte Datensatz in der Datei kann möglicherweise kürzer sein.
  • Wählen Sie Mit Begrenzer aus, wenn die verarbeiteten Datensätze durch ein DOS- oder UNIX-Linienende bzw. durch eine Folge benutzerdefinierter Begrenzerbytes getrennt bzw. beendet werden. Geben Sie für die Eigenschaften Begrenzer und Begrenzertyp den Begrenzer und den Begrenzertyp an.
  • Wählen Sie die Option Syntaktisch analysierte Folge aus, wenn die Daten eine Folge von einem oder mehreren Datensätzen enthält, die von dem unter Nachrichtendomäne angegebenen Parser seriell erkannt werden. Die einzelnen erkannten Datensätze werden vom Knoten jeweils als separate Nachrichten weitergegeben. Bei Auswahl der Option Datensatzerkennung muss unter Nachrichtendomäne entweder ein XMLNSC- oder ein MRM-Parser angegeben sein (das physische Format muss CWF oder TDS sein).
Länge (Bytes) Ja Nein 0 Wenn Sie Datensatzerkennung auf Feste Länge gesetzt haben, geben Sie als Länge die erforderliche Länge des Ausgabesatzes in Bytes an. Dieser Wert muss im Bereich zwischen 1 Byte und 100 MB liegen. Der Standardwert beträgt 80 Bytes.

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 TCPIPServerReceive-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ügaren Speicher optimal zu nutzen, müssen möglicherweise die im Beispiel für umfangreiche Nachrichtenausgaben beschriebenen Nachrichtenflusstechniken angewandt werden.

Begrenzer Ja Nein DOS- oder UNIX-Linienende Wenn Sie Datensatzerkennung auf Mit Begrenzer setzen, müssen Sie als Begrenzer den zu verwendenden Begrenzer angeben. Folgende Optionen stehen zur Auswahl:
  • DOS- oder UNIX-Zeilenende gibt auf UNIX-Systemen das Zeilenvorschubzeichen (<LF>, X'0A') und auf Windows-Systemen ein Rücklaufzeichen gefolgt von einem Zeilenvorschubzeichen (<CR><LF>, X'0D0A') an. Der Knoten behandelt beide Zeichenfolgen als Begrenzer, unabhängig davon, auf welchem System der Broker ausgeführt wird. Falls beide Zeichenfolgen im gleichen Datensatz angezeigt werden, erkennt der Knoten beide als Begrenzer. X'15' wird vom Knoten hingegen nicht erkannt. Diese Zeichenfolge steht auf z/OS-Systemen für das Neue-Zeile-Byte. Wenn die Eingabedatei mit der EBCDIC-Zeichenfolge für neue Zeilen codiert ist, wie beispielsweise EBCDIC-Dateien von einem z/OS-System, setzen Sie diese Eigenschaft auf Angepasster Begrenzer und setzen Sie Angepasster Begrenzer auf 15 angeben.
  • Angepasster Begrenzer (hexadezimal): Hier können Sie für Angepasster Begrenzer (hexadezimal) eine Bytefolge angeben.
Angepasster Begrenzer (hexadezimal) Nein Nein   Das Begrenzerbyte oder die Begrenzerbytes, das bzw. die verwendet werden sollen, 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. Geben Sie diesen Wert als geradzahlige Zeichenfolge mit Hexadezimalziffern an. Der Standardwert ist X'0A', die maximale Länge der Zeichenfolge beträgt 16 Bytes (dargestellt durch 32 Hexadezimalziffern).
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:
  • Infix. Bei Auswahl dieses Werts wird jeder Begrenzer zum Trennen von Datensätzen eingesetzt. Wenn die Daten mit einem Begrenzer enden, werden die Daten (der Länge null) nach dem letzten Begrenzer ebenfalls weitergegeben, obwohl keine Daten enthalten sind.
  • Postfix. Bei Angabe dieses Werts werden Datensätze durch jeden Begrenzer beendet. Wenn die Daten mit einem Begrenzer enden, wird kein leerer Datensatz nach dem Begrenzer weitergegeben. Enden die Daten nicht mit einem Begrenzer, werden sie genauso verarbeitet, als ob den letzten Bytes der Daten ein Begrenzer folgen würde. Postfix ist der Standardwert.

Der TCPIPServerReceive-Knoten sieht jedes Vorkommen des Begrenzers in der Eingabe als trennenden Begrenzer (Infix) oder beendenden Begrenzer (Postfix) für die einzelnen Datensätze an. Wenn die Daten mit einem Begrenzer beginnen, behandelt der Knoten den Inhalt (der Länge null) vor diesem Begrenzer als Datensatz und gibt somit einen leeren Datensatz an den Fluss weiter. Der Begrenzer wird niemals in die weitergegebene Nachricht aufgenommen.

Diese Eigenschaft wird ignoriert, es sei denn, Begrenzer ist auf Angepasster Begrenzer (hexadezimal) gesetzt.

In der folgenden Tabelle werden die Auswertungseigenschaften des TCPIPServerReceive-Knotens beschrieben.

Eine umfassende Beschreibung dieser Eigenschaften finden Sie unter Auswertungseigenschaften.

Eigenschaft O K Standardwert Beschreibung Eigenschaft des Befehls mqsiapplybaroverride
Auswertung Nein Ja Keine Durch diese Eigenschaft wird gesteuert, ob eine Auswertung stattfindet. Gültige Werte sind:
  • Ohne
  • Inhalt und Wert
  • Inhalt
  • Übernehmen
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:
  • Benutzertrace
  • Lokales Fehlerprotokoll
  • Ausnahme
  • Ausnahmeliste
 
Die Überwachungseigenschaften des Knotens werden in der folgenden Tabelle beschrieben.
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.

Bemerkungen | Marken | Downloads | Bibliothek | Support | Feedback

Copyright IBM Corporation 1999, 2014Copyright IBM Corporation 1999, 2014.

        
        Letzte Aktualisierung:
        
        Letzte Aktualisierung: 2015-02-28 16:20:32


ReferenzthemaReferenzthema | Version 8.0.0.5 | ac67350_