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.

TCPIPServerOutput-Knoten

Mithilfe des TCPIPServerOutput-Knotens können Sie eine Serververbindung mit einem unformatierten TCP/IP-Socket erstellen und über die Verbindung Daten an eine externe Anwendung senden.

Zweck

Der TCPIPServerOutput-Knoten ist an einem TCP/IP-Port empfangsbereit und wartet darauf, dass ein Clientknoten eine Verbindung zu dem Port herstellt. Wenn sich der Clientknoten mit dem Port verbindet, erstellt der Serverknoten eine Verbindung für den Client. Die Verbindungen werden nicht direkt durch den Knoten hergestellt, sondern werden über einen Verbindungspool bezogen, der von der WebSphere Message Broker-Ausführungsgruppe verwaltet wird.

Die Ausführungsgruppe bestimmt mithilfe des konfigurierbaren TCPIPServer-Standardservice, welche Attribute für die Socketverbindung verwendet werden. Wenn der konfigurierbare Service jedoch auf dem Knoten festgelegt ist, wird der konfigurierbare Service für alle Eigenschaften, einschließlich Host und Portnummer, verwendet.

Sobald die Verbindung hergestellt wurde, werden die Daten gesendet. Wenn die Daten nicht erfolgreich innerhalb des Zeitlimits gesendet werden, das durch die Eigenschaft Zeitlimitüberschreitung beim Senden eines Datensatzes (Sekunden) des Knotens festgelegt wurde, 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 Beschreibung
$LocalEnvironment/Destination/TCPIP/Output/Hostname Der Hostname für die Herstellung einer Verbindung
$LocalEnvironment/Destination/TCPIP/Output/Port Die Portnummer für die Herstellung einer Verbindung
$LocalEnvironment/Destination/TCPIP/Output/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/Destination/TCPIP/Output/ReplyId Die Antwort-ID, die für diese Verbindung gespeichert ist. Hierbei kann es sich um eine beliebige Zeichenfolge handeln.
$LocalEnvironment/Destination/TCPIP/Output/Timeout Der Zeitlimitwert, der beim Senden von Daten an die TCP/IP-Serververbindung verwendet wird. Dieser Wert setzt die auf dem Knoten angegebene Eigenschaft Zeitlimitüberschreitung beim Senden eines Datensatzes außer Kraft.

Ü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. Dieses Verhalten kann zum Speichern von Antwort-IDs aus anderen TCP/IP-Knoten oder aus anderen Transportprotokollen wie WebSphere MQ genutzt werden.

In der Knotenausgabe sind dieselben Informationen wie in der Eingabe enthalten. Felder, die in der Eingabe fehlen, werden mit Details aus der verwendeten Verbindung aktualisiert. Wenn beispielsweise die Eigenschaft Id nicht als Eingabe bereitgestellt wird (da Sie eine Verbindung erstellen oder eine Poolverbindung wiederverwenden möchten), enthält die lokale Umgebung der Ausgabe die ID der verwendeten Verbindung.

Tabelle 2. Ausgabeeigenschaften der lokalen Umgebung
Position in der lokalen Umgebung Beschreibung
$LocalEnvironment/WrittenDestination/TCPIP/Output/ConnectionDetails/Hostname Der Hostname für die Herstellung einer Verbindung
$LocalEnvironment/WrittenDestination/TCPIP/Output/ConnectionDetails/Port Die Portnummer für die Herstellung einer Verbindung
$LocalEnvironment/WrittenDestination/TCPIP/Output/ConnectionDetails/OpenTimestamp Die Zeitmarke für die erste Öffnung der Verbindung
$LocalEnvironment/WrittenDestination/TCPIP/Output/ConnectionDetails/CloseTimestamp Die Zeitmarke für das Schließen der Verbindung (null, wenn noch nicht geschlossen)
$LocalEnvironment/WrittenDestination/TCPIP/Output/ConnectionDetails/SequenceNumber Die Folgenummer der in dieser Verbindung empfangenen Nachricht. Der erste Datensatz hat die Folgenummer 1, der zweite Datensatz die Folgenummer 2 etc.
$LocalEnvironment/WrittenDestination/TCPIP/Output/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/WrittenDestination/TCPIP/Output/ConnectionDetails/ReplyId Die Antwort-ID, die für diese Verbindung gespeichert ist. Hierbei kann es sich um eine beliebige Zeichenfolge handeln.
$LocalEnvironment/WrittenDestination/TCPIP/Output/ConnectionDetails/ClientDetails/Hostname Der vollständig qualifizierte Domänenname des Computers, über den der Client verbunden ist.
$LocalEnvironment/WrittenDestination/TCPIP/Output/ConnectionDetails/ClientDetails/Address Die IP-Adresse des Computers, über den der Client verbunden ist.

Wenn während der Nutzung des TCP/IP-Transports die Verbindung aufgehoben wird (oder eine andere Art von Ausnahmebedingung auftritt), wird eine Ausnahmebedingung ausgegeben. Diese Ausnahme wird an das Fehlerterminal geleitet, sofern eine Verbindung besteht. Andernfalls wird die Ausnahme an eine Stelle weiter hinten im Nachrichtenfluss zurückgegeben.

Der Knoten verfügt außerdem über ein Close-Eingabeterminal. Wenn eine Nachricht an dieses Terminal gesendet wird, wird die Verbindung unter Verwendung einer Kombination der Details, die im Knoten und in der lokalen Umgebung bereitgestellt werden, an dieses Terminal gesendet.

Der TCPIPServerOutput-Knoten befindet sich im Ablagefach TCPIP der Palette und wird in der Workbench durch folgendes Symbol dargestellt:

Symbol für TCPIPServerOutput-Knoten

TCPIPServerOutput-Knoten in einem Nachrichtenfluss verwenden

Der TCPIPServerOutput-Knoten kann in jedem Nachrichtenfluss verwendet werden, der Daten an eine externe Anwendung senden muss. Die folgenden Mustercodes verdeutlichen die Verwendung dieses Knotens:

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 TCPIPServerOutput-Knoten konfigurieren

Wenn Sie eine Instanz des TCPIPServerOutput-Knotens in einen Nachrichtenfluss eingereiht haben, können Sie ihn konfigurieren (weitere Informationen siehe unter Nachrichtenflussknoten konfigurieren). Die Knoteneigenschaften werden in der Eigenschaftenansicht angezeigt. In dieser Ansicht sind alle obligatorischen Eigenschaften, für die Sie einen Wert eingeben müssen (d. h. Eigenschaften ohne definierten Standardwert) mit einem Stern markiert.

So konfigurieren Sie einen TCPIPServerOutput-Knoten:

  1. Optional: Geben Sie auf der Registerkarte Beschreibung eine Kurzbeschreibung, eine ausführliche Beschreibung oder beides 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 die Portnummer, die verwendet werden soll, 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 der Portnummer 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.
    • Mit der Eigenschaft Zeitlimitüberschreitung beim Senden eines Datensatzes (Sekunden) können Sie festlegen, wie lange der Knoten wartet, wenn er versucht, Daten zu senden. Sie können einen beliebigen Zeitwert in Sekunden angeben. Sobald die festgelegte Zeitspanne überschritten ist, werden alle verfügbaren Daten an das Fehlerterminal (Failure) gesendet. Der Standardwert beträgt 60 Sekunden.
  3. Legen Sie auf der Registerkarte Erweitert die Eigenschaften fest, die bestimmen, wie der Datenstrom gesteuert wird.
    • Mit der Eigenschaft Senden an können Sie festlegen, ob die Daten an eine Verbindung oder an alle verfügbaren Verbindungen gesendet werden sollen.
      • Wählen Sie Eine Verbindung aus, wenn die Nachricht nur an eine Verbindung gesendet werden soll, wie durch die Knoteneigenschaften und Nachrichtenüberschreibungen angegeben. Dies ist die Standardeinstellung.
      • Wählen Sie Alle verfügbaren Verbindungen aus, wenn die Daten an alle verfügbaren Verbindungen gesendet werden sollen.
    • 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 gesendet wurden aus, wenn die Verbindung aufgehoben werden soll, sobald das Ende des Datensatzes gesendet wurde.
    • Wählen Sie Ausgabedatenstrom nach Senden eines Datensatzes schließen aus, wenn der Ausgabedatenstrom geschlossen werden soll, sobald die Daten gesendet wurden. Diese Eigenschaft ist standardmäßig nicht ausgewählt.
    • 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.
    • Verwenden Sie die Eigenschaft Änderung Eingabedatenstrom, um den Eingabedatenstrom für die Verwendung durch Eingangs- und Empfangsknoten, die eine Verbindungs-ID angeben, zu reservieren oder um den Eingabedatenstrom am Ende des Nachrichtenflusses freizugeben.
      • 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.
  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 über die Schaltfläche Bearbeiten rechts neben den einzelnen Eigenschaften aufrufen können.
    1. Geben Sie unter Datenposition die Position der Eingabedaten an. Dies ist die Position in der Baumstruktur für Eingabenachrichten, an welcher der zu schreibende Datensatz enthalten ist. Der Standardwert ist $Body, d. h. der gesamte Nachrichtenhauptteil ($InputRoot.Body).
      Wenn Sie diese Eigenschaft angeben und die Daten in der Nachrichtenbaumstruktur, die mit der Eigenschaft angegeben werden, einem modellgesteuerten Parser (beispielsweise einem MRM- oder XMLNSC-Parser) angehören, ist Folgendes zu berücksichtigen:
      • Wenn Sie das MRM CWF-Format verwenden, müssen Sie sicherstellen, dass die angegebene Nachrichtenbaumstruktur als Nachrichtendefinition vorliegt. Wenn diese Nachrichtenbaumstruktur nur als globales Element definiert ist, werden die Ausnahmen BIP5180 und BIP5167 generiert.
      • Wenn Sie das MRM TDS-Format verwenden, kann die Serialisierung der angegebenen Nachricht auf jeden Fall erfolgreich durchgeführt werden, unabhängig davon, ob das Element als globales Element oder als Nachricht definiert ist. Wird das angegebene Feld jedoch nicht als globales Element oder als Nachricht gefunden, geschieht Folgendes:
        • Wenn dieses Feld ein Leaf-Feld in der Nachrichtenbaumstruktur ist, wird das Feld als selbstdefinierend geschrieben. In diesem Fall wird keine Überprüfung durchgeführt, selbst wenn die Prüfung aktiviert ist.
        • Wenn dieses Feld ein komplexes Element ist, wird die interne Ausnahme BIP5522 generiert, die darauf hinweist, dass der logische Typ nicht in eine Zeichenfolge konvertiert werden kann.
      • Wenn Sie MRM XML verwenden, entsprechen die Ereignisse dem MRM TDS-Format, außer wenn es sich um ein komplexes Element handelt. Dann wird es als selbstdefinierend geschrieben.
      • Wenn Sie den XMLNSC-Parser verwenden, wird keine Überprüfung durchgeführt, selbst wenn die Prüfung aktiviert ist.
    2. 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/Destination/TCPIP/Output/Port.
    3. 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/Destination/TCPIP/Output/Id.
    4. 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/Destination/TCPIP/Output/ReplyId.
  5. Auf der Registerkarte Datensätze und Elemente können Sie angeben, wie der aus der Nachricht abgeleitete Datensatz von dem TCPIPServerOutput-Knoten geschrieben wird.
    • In Datensatzdefinition stehen folgende Werte zur Auswahl:
      • Datensatz 'Nicht geänderte Daten' gibt an, dass Datensätze nicht geändert werden. Dies ist die Standardeinstellung.
      • Datensatz 'Daten mit fester Länge' gibt an, dass Datensätze bei Bedarf bis zu einer angegebenen Länge aufgefüllt werden. Die Länge wird in der Eigenschaft Länge definiert. Wenn die Länge des Dokuments den unter Länge angegebenen Wert überschreitet, generiert der Knoten eine Ausnahme. Geben Sie über die Eigenschaft Auffüll-Byte an, welches Byte zum Auffüllen der Nachricht bis zur erforderlichen Länge verwendet werden soll.
      • Datensatz 'Daten mit Begrenzer' gibt an, dass Datensätze durch einen Begrenzer getrennt und durch Verknüpfung akkumuliert werden. Der Begrenzer wird durch die Eigenschaften Begrenzer, Angepasster Begrenzer und Begrenzertyp angegeben. Die Datei wird erst beendet, wenn am Dateibeendigungsterminal eine Nachricht empfangen wird.
    • Geben Sie unter Länge an, wie lang die Datensätze sein sollen (in Bytes), wenn Datensatzdefinition auf Datensatz 'Daten mit fester Länge' gesetzt ist. Sind Datensätze länger als hier angegeben, wird eine Ausnahmebedingung ausgelöst. Dieser Wert muss im Bereich zwischen 1 Byte und 100 MB liegen. Der Standardwert beträgt 80 Bytes.
    • Wenn Datensatzdefinition auf Datensatz 'Daten mit fester Länge' gesetzt ist, geben Sie über die Option Auffüll-Byte an, welches Byte zum Auffüllen von Datensätzen verwendet werden soll, die kürzer als angegeben sind. Geben Sie diesen Wert in Form von zwei Hexadezimalziffern an. Der Standardwert ist X'20'.
    • Geben Sie unter Begrenzer den Begrenzer an, der verwendet werden soll, wenn Datensatzdefinition auf Datensatz 'Daten mit Begrenzer' gesetzt ist. Zur Auswahl stehen:
      • Linienende des Brokersystems gibt an, dass eine dem Dateisystem, auf dem der Broker ausgeführt wird, entsprechende Zeilenende-Bytefolge als Begrenzer verwendet werden soll. Dies ist die Standardeinstellung. Auf Windows-Systemen ist dieser Wert ein 'Rücklauf-Zeilenvorschub'-Paar (X'0D0A'), auf UNIX-Systemen ein einzelnes 'Zeilenvorschub'-Byte (X'0A') und auf z/OS-Systemen ein 'Zeilenumbruch'-Byte (X'15').
      • Angepasster Begrenzer gibt an, dass mit der in der Eigenschaft Angepasster Begrenzer definierten expliziten Begrenzerfolge Datensätze begrenzt werden sollen.
    • Geben Sie unter Angepasster Begrenzer die Begrenzerbytefolge an, die zum Begrenzen von Datensätzen verwendet werden soll, wenn die Eigenschaft Begrenzer auf Angepasster Begrenzer gesetzt ist. Geben Sie diesen Wert als geradzahlige Zeichenfolge mit Hexadezimalziffern an. Der Standardwert ist X'0A' und die maximale Länge der Zeichenfolge beträgt 16 Bytes.
    • Wenn Sie Datensatzdefinition auf Datensatz 'Daten mit Begrenzer' setzen, geben Sie unter Begrenzertyp an, mit welcher Art von Begrenzer die Datensätze getrennt werden sollen. Folgende Werte stehen zur Auswahl:
      • Postfix gibt an, dass nach jedem geschriebenen Datensatz ein Begrenzer eingefügt wird. Dies ist die Standardeinstellung.
      • Infix gibt an, dass der Begrenzer nur zwischen zwei benachbarten Datensätzen eingefügt wird.
  6. Geben Sie auf der Registerkarte Auswertung die Eigenschaften für die Parser-Auswertung des Knotens an. Weitere Informationen zur Auswertung finden Sie im Abschnitt Nachrichten überprüfen. Informationen zur Vorgehensweise bei der Auswertung dieser Registerkarte finden Sie im Abschnitt Eigenschaften der Registerkarte 'Auswertung'.

Terminals und Eigenschaften

In der folgenden Tabelle werden die TCPIPServerOutput-Knotenterminals beschrieben.

Terminal Typ Beschreibung
Eingabeterminal (In) Eingabedaten Das Eingabeterminal, das eine Nachricht zur Verarbeitung durch einen Knoten annimmt
Close Eingabesteuerung Das Eingabeterminal, an das eine Nachricht weitergeleitet wird, wenn die Verbindung, die in der lokalen Umgebung angegeben ist, aufgehoben wird.
Ausgabeterminal (Out) Ausgabedaten Das Ausgabeterminal, an das die Nachricht geleitet wird, wenn sie erfolgreich an eine externe Ressource gesendet wird. Die am Eingangsterminal empfangene Nachricht wird an das Ausgangsterminal weitergegeben und bleibt mit Ausnahme der zusätzlichen Statusinformationen unverändert.
Close Ausgabesteuerung Das Ausgabeterminal, an das eine Nachricht aus dem Close-Eingabeterminal geleitet wird.
Fehlerterminal (Failure) Ausgabedaten Das Ausgabeterminal, an das die Eingabenachricht geleitet wird, wenn im Knoten ein Fehler auftritt.

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 für die Implementierung zur BAR-Datei hinzugefügt wird).

In der folgenden Tabelle werden die Beschreibungseigenschaften des TCPIPServerOutput-Knotens beschrieben:
Eigenschaft O K Standardwert Beschreibung
Knotenname Nein Nein TCPIPServerOutput 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

In der folgenden Tabelle werden die Basiseigenschaften des TCPIPServerOutput-Knotens 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. connectionDetails
Zeitlimitüberschreitung beim Senden eines Datensatzes (Sekunden) Ja Ja 60 Gibt an, wie lange der Knoten wartet, wenn er versucht, Daten zu senden. Sie können einen beliebigen Zeitwert in Sekunden angeben. timeoutSendingData

In der folgenden Tabelle werden die erweiterten Eigenschaften des TCPIPServerOutput-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:
  • Nein
  • Nach Zeitlimitüberschreitung
  • Nachdem Daten gesendet wurden
Ausgabedatenstrom nach Senden eines Datensatzes schließen Ja Nein Nicht ausgewählt Gibt an, ob der Ausgabedatenstrom geschlossen werden soll, sobald die Daten gesendet wurden. Diese Eigenschaft ist standardmäßig nicht ausgewählt.
Ä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:
  • Unverändert lassen
  • Ausgabedatenstrom freigeben
  • Ausgabedatenstrom reservieren (für Nutzung durch künftige TCP/IP-Knoten)
  • Ausgabedatenstrom reservieren (für Nutzung durch künftige TCP/IP-Knoten), dann am Ende des Datenflusses freigeben.
Ä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:
  • Unverändert lassen
  • Eingabedatenstrom freigeben
  • Eingabedatenstrom reservieren (für Nutzung durch künftige TCP/IP-Knoten)
  • Eingabedatenstrom reservieren (für Nutzung durch künftige TCP/IP-Knoten), dann am Ende des Datenflusses freigeben.
Wenn der Eingabedatenstrom der Verbindung reserviert ist, kann er ohne Angabe der richtigen Verbindungs-ID von keinem anderen Knoten verwendet werden. Wenn der Eingabedatenstrom nach der Weiterleitung der Nachricht freigegeben wird, wird er an den Pool zurückgegeben und steht anderen Eingabe- oder Empfangsknoten zur Nutzung zur Verfügung.
Senden an: Ja Nein Eine Verbindung Gibt an, ob die Daten an eine Verbindung oder an alle verfügbaren Verbindungen gesendet werden sollen. Folgende Optionen sind gültig:
  • Eine Verbindung
  • Alle verfügbaren Verbindungen

In der folgenden Tabelle werden die Anforderungseigenschaften des TCPIPServerOutput-Knotens beschrieben:

Eigenschaft O K Standardwert Beschreibung
Datenposition Ja Nein $Body Die Position in der Baumstruktur für Eingabenachrichten, die den zu schreibenden Datensatz enthält.
Position des Ports Ja Nein $LocalEnvironment/Destination/TCPIP/Output/Port Die Position des Nachrichtenelements, die den Port enthält.
ID Ja Nein $LocalEnvironment/Destination/TCPIP/Output/Id Die Position des Nachrichtenelements, die die ID enthält.
Position für Antwort-ID Ja Nein $LocalEnvironment/Destination/TCPIP/Output/ReplyId Die Position des Nachrichtenelements, die die Antwort-ID enthält.

In der folgenden Tabelle werden die Datensatz- und Elementeigenschaften des TCPIPServerOutput-Knotens beschrieben:

Eigenschaft O K Standardwert Beschreibung
Dokumentdefinition Ja Nein Datensatz 'Nicht geänderte Daten' Über diese Eigenschaft wird gesteuert, wie die Datensätze, die aus der Nachricht abgeleitet wurden, geschrieben werden. Folgende Optionen sind gültig:
  • Datensatz 'Nicht geänderte Daten'
  • Datensatz 'Daten mit fester Länge'
  • Datensatz 'Daten mit Begrenzer'
Länge (Bytes) Ja Nein 0 Die erforderliche Länge des Ausgabesatzes. Diese Eigenschaft ist nur anwendbar, wenn Datensatzdefinition auf Datensatz 'Daten mit fester Länge' gesetzt ist.
Auffüll-Byte (hexadezimal) Ja Nein 20 Das aus zwei Hexadezimalzeichen bestehende Byte, mit dem kurze Nachrichten aufgefüllt werden, wenn Datensatzdefinition auf Datensatz 'Daten mit fester Länge' gesetzt ist.
Begrenzer Ja Nein Linienende des Brokersystems Der zu verwendende Begrenzer, wenn Datensatzdefinition auf Datensatz 'Daten mit Begrenzer' gesetzt ist. Folgende Optionen sind gültig:
  • Linienende des Brokersystems
  • Angepasster Begrenzer (hexadezimal)
Angepasster Begrenzer (hexadezimal) Nein Nein Ohne Die als Begrenzer dienende Bytefolge, die zu verwenden ist, wenn Datensatzdefinition auf Datensatz 'Daten mit Begrenzer' und Begrenzer auf Angepasster Begrenzer (hexadezimal) gesetzt sind.
Begrenzertyp Ja Nein Postfix Mit dieser Eigenschaft wird angegeben, wie Begrenzer zwischen den einzelnen Datensätzen eingefügt werden, wenn Datensatzdefinition auf Datensatz 'Daten mit Begrenzer' gesetzt ist. Folgende Optionen sind gültig:
  • Infix
  • Postfix

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

Eine umfassende Beschreibung dieser Eigenschaften finden Sie unter Auswertungseigenschaften.

Eigenschaft O K Standardwert Beschreibung Eigenschaft des Befehls mqsiapplybaroverride
Auswerten Nein Ja Übernehmen 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 | ac67340_