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.

TCPIPClientOutput-Knoten

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

Zweck

Der TCPIPClientOutput-Knoten öffnet Verbindungen mit einer fernen Serveranwendung, die an einem TCP/IP-Port empfangsbereit ist. 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 TCPIPClient-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.

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.

Der konfigurierbare TCPIPClient-Service kann zur Erstellung eines Clientverbindungspools, der zur Verarbeitung bereit ist, verwendet werden. Zur Aktivierung dieser Funktion muss die Eigenschaft minimumConnections auf einen höheren Wert als null gesetzt werden. Die Ausführungsgruppe stellt sicher, dass die angegebene Anzahl an Verbindungen immer zur Verfügung steht, indem sie diese beim Start erstellt und so lange weiter Verbindungen erstellt, bis der Mindestwert erreicht ist.

Der Knoten fordert eine Clientverbindung an und der Sendeknoten verlangt, dass der Pool eine neue Verbindung erstellt, falls keine Verbindungen zum Senden von Daten verfügbar sind. Wenn der Wert der Eigenschaft maximumConnections noch nicht überschritten wurde, wird eine neue Verbindung erstellt.

Sobald die Verbindung hergestellt wurde, werden die Daten gesendet. Wenn die Daten nicht erfolgreich innerhalb des Zeitlimits gesendet wurden, das durch die Eigenschaft Zeitlimitüberschreitung beim Senden eines Datensatzes (Sekunden) des Knotens festgelegt wurde, wird eine Ausnahmebedingung ausgegeben.

Die Eigenschaften in der lokalen Umgebung können die vom Knoten verwendete TCP/IP-Verbindung außer Kraft setzen:

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. Dieser Wert 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 in dieser Verbindung gespeichert wurde. 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-Clientverbindung verwendet wird. Dieser Wert setzt die auf dem Knoten angegebene Eigenschaft Zeitlimitüberschreitung beim Senden eines Datensatzes außer Kraft.

Über diese Eigenschaft können die Verbindungsdetails (Hostname und Portnummer) und die verwendete Verbindung (ID) dynamisch ausgewählt werden. Sie können auch die Antwort-ID für die Verbindung festlegen. Mithilfe der Antwort-ID kann eine Zeichenfolge in der Verbindung gespeichert und in der lokalen Umgebung sichtbar gemacht werden. Über diese Verbindung können Antwort-IDs von anderen TCP/IP-Knoten oder aus anderen Transportprotokollen, z. B. WebSphere MQ, gespeichert werden.

Die Ausgabe des Knotens enthält dieselben Informationen wie die Eingabe. Außerdem werden Felder, die in der Eingabe fehlten, mit den Details aus der verwendeten Verbindung aktualisiert. Wenn beispielsweise die Eigenschaft Id nicht als Eingabe bereitgestellt wird (da Sie eine neue 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 usw.
$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 in dieser Verbindung gespeichert wurde. Hierbei kann es sich um eine beliebige Zeichenfolge handeln.

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 wird an das Fehlerterminal (Failure) (falls vorhanden) weitergeleitet; andernfalls wird die Ausnahmebedingung an eine Stelle weiter hinten im Fluss 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 TCPIPClientOutput-Knoten befindet sich im Ablagefach TCPIP der Palette und wird in der Workbench durch folgendes Symbol dargestellt:

Symbol für TCPIPClientOutput-Knoten

TCPIPClientOutput-Knoten in einem Nachrichtenfluss verwenden

Der TCPIPClientOutput-Knoten kann nicht in einem 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 TCPIPClientOutput-Knoten konfigurieren

Wenn Sie eine Instanz des TCPIPClientOutput-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 TCPIPClientOutput-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 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 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.
    • 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 er 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.
  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. Zu den 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.
    1. Geben Sie unter Datenposition den Standort der Eingabedaten an. Dieser Wert ist die Position in der Baumstruktur für Eingabenachrichten, die den zu schreibenden Datensatz enthält. Der Standardwert ist $Body, d. h. der gesamte Nachrichtenhauptteil ($InputRoot.Body).
      Wenn Sie diese Eigenschaft angeben und die Daten in der Nachrichtenbaumstruktur, die durch diese Eigenschaft angegeben wird, einem modellgesteuerten Parser angehören(beispielsweise einem MRM- oder XMLNSC-Parser), müssen Sie Folgendes berücksichtigen:
      • Wenn Sie das MRM CWF-Format verwenden, müssen Sie sicherstellen, dass die angegebene Nachrichtenbaumstruktur als Nachrichtendefinition vorliegt. Wenn dieser Wert 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 dieser Wert 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 dieser Wert 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. Dieses wird 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 Hostname die Position des Werts an, mit dem die Einstellung Hostname in der Eigenschaft Verbindungsdetails auf der Registerkarte Grundeinstellung überschrieben werden soll. Wenn Sie keinen Standort angeben, lautet der Standardwert $LocalEnvironment/Destination/TCPIP/Output/Hostname.
    3. Geben Sie unter Position für Port die Position des Werts an, mit dem die 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.
    4. 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.
    5. Geben Sie unter Position für Antwort-ID 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/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 TCPIPClientOutput-Knoten geschrieben wird.
    • In Datensatzdefinition stehen folgende Optionen zur Auswahl:
      • Datensatz 'Nicht geänderte Daten' - Mit dieser Option wird festgelegt, dass Datensätze nicht geändert werden. Dies ist die Standardeinstellung.
      • Datensatz 'Daten mit fester Länge' - Bei Verwendung dieser Option werden Datensätze gegebenenfalls bis zu einer angegebenen Länge aufgefüllt. 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 (hexadezimal) an, welches Byte zum Auffüllen der Nachricht bis zur erforderlichen Länge verwendet werden soll.
      • Datensatz 'Daten mit Begrenzer' - Mit dieser Option wird angegeben, dass Datensätze durch einen Begrenzer getrennt und durch Verknüpfung akkumuliert werden sollen. 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 (Bytes) an, wie lang die Datensätze sein sollen (in Bytes), wenn unter Datensatzdefinition die Option Datensatz 'Daten mit fester Länge' angegeben ist. Sind Datensätze länger als hier angegeben, wird eine Ausnahmebedingung ausgegeben. Dieser Wert muss im Bereich zwischen 1 Byte und 100 MB liegen. Der Standardwert beträgt 80 Bytes.
    • Geben Sie über die Option Auffüll-Byte (hexadezimal) an, welches Byte zum Auffüllen von Datensätzen verwendet werden soll, die kürzer als angegeben sind, wenn für Datensatzdefinition die Option Datensatz 'Daten mit fester Länge' angegeben ist. Geben Sie diesen Wert in Form von 2 Hexadezimalziffern an. Der Standardwert ist X'20'.
    • Geben Sie unter Begrenzer den Begrenzer an, der verwendet werden soll, wenn unter Datensatzdefinition die Option Datensatz 'Daten mit Begrenzer' angegeben wird. Zur Auswahl stehen:
      • Linienende des Brokersystems - Mit dieser Option wird angegeben, dass eine Zeilenende-Bytefolge als geeigneter Begrenzer für das Dateisystem, auf dem der Broker ausgeführt wird, 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 (hexadezimal) - Mit dieser Option wird angegeben, dass mit der in der Eigenschaft Angepasster Begrenzer definierten expliziten Begrenzerfolge Datensätze begrenzt werden sollen.
    • Geben Sie unter Angepasster Begrenzer (hexadezimal) die Begrenzer-Bytefolge an, mit der Datensätze begrenzt werden sollen, wenn für die Eigenschaft Begrenzer die Option Angepasster Begrenzer angegeben 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. Zur Auswahl stehen:
      • Postfix - Mit dieser Option wird angegeben, dass nach jedem geschriebenen Datensatz ein Begrenzer eingefügt wird. Dies ist die Standardeinstellung.
      • Infix - Mit dieser Option wird angegeben, dass der Begrenzer zwischen zwei benachbarten Datensätzen eingefügt werden soll.
  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 zum Ausfüllen dieser Registerkarte finden Sie im Abschnitt Eigenschaften der Registerkarte 'Auswertung'.

Terminals und Eigenschaften

In der folgenden Tabelle werden die TCPIPClientOutput-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 zur BAR-Datei hinzugefügt wird, um ihn einzusetzen).

In der folgenden Tabelle werden die Beschreibungseigenschaften des TCPIPClientOutput-Knotens beschrieben:
Eigenschaft O K Standardwert Beschreibung
Knotenname Nein Nein TCPIPClientOutput 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 TCPIPClientOutput-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 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 TCPIPClientOutput-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 Nachrichtenflusses 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 verfügbare Verbindungen gesendet werden sollen. Folgende Optionen sind gültig:
  • Eine Verbindung
  • Alle verfügbaren Verbindungen

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

Eigenschaft O K Standardwert Beschreibung
Datenposition Ja Nein $Body Die Position in der Baumstruktur für Eingabenachrichten, in welcher der zu schreibende Datensatz enthalten ist.
Position des Hostnamens Ja Nein $LocalEnvironment/Destination/TCPIP/Output/Hostname Die Position des Nachrichtenelements, das den Hostnamen enthält.
Position des Ports Ja Nein $LocalEnvironment/Destination/TCPIP/Output/Port Die Position des Nachrichtenelements, das den Port enthält.
Position für 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 TCPIPClientOutput-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 unter Datensatzdefinition die Option Datensatz 'Daten mit fester Länge' angegeben ist.
Auffüll-Byte (hexadezimal) Ja Nein 20 Das aus zwei Hexadezimalzeichen bestehende Byte, mit dem kurze Nachrichten aufgefüllt werden, wenn unter Datensatzdefinition die Option Datensatz 'Daten mit fester Länge' angegeben ist.
Begrenzer Ja Nein Linienende des Brokersystems Der zu verwendende Begrenzer, wenn unter Datensatzdefinition die Option Datensatz 'Daten mit Begrenzer' angegeben 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 für die Eigenschaft Datensatzdefinition die Option Datensatz 'Daten mit Begrenzer' und für die Eigenschaft Begrenzer die Option Angepasster Begrenzer (hexadezimal) angegeben ist.
Begrenzertyp Ja Nein Postfix Mit dieser Eigenschaft wird angegeben, wie Begrenzer zwischen den einzelnen Datensätzen eingefügt werden, wenn unter Datensatzdefinition die Option Datensatz 'Daten mit Begrenzer' angegeben ist. Folgende Optionen sind gültig:
  • Infix
  • Postfix

In der folgenden Tabelle werden die Auswertungseigenschaften des TCPIPClientOutput-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:31


ReferenzthemaReferenzthema | Version 8.0.0.5 | ac67310_