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.

FTEOutput-Knoten

Verwenden Sie den FTEOutput-Knoten, um mithilfe von WebSphere MQ File Transfer Edition Nachrichten in Dateien zu schreiben.

Dieses Thema ist in folgende Abschnitte eingeteilt:

Zweck

Mithilfe des FTEOutput-Knotens können Sie die WebSphere Message Broker Version 8.0-Unterstützung für die Dateiverarbeitung durch die Integration mit WebSphere MQ File Transfer Edition erweitern. WebSphere MQ File Transfer Edition ist ein verwaltetes Dateiübertragungsprodukt, das WebSphere MQ als Transportmethode verwendet.

Der FTEOutput-Knoten befindet sich im Ablagefach Datei der Palette und wird im WebSphere Message Broker Toolkit durch folgendes Symbol dargestellt:

Symbol für den FTEOutput-Knoten

Verwendung dieses Knotens in einem Nachrichtenfluss

Der FTEOutput-Knoten kann in jedem Nachrichtenfluss verwendet werden, in dem Dateien über ein WebSphere MQ File Transfer Edition-Netz gesendet werden sollen. Das folgende Beispiel zeigt, wie dieser Knoten verwendet wird:

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.

Terminals und Eigenschaften

In der folgenden Tabelle werden die Terminals des FTEOutput-Knotens beschrieben:

Terminal Beschreibung
Eingabeterminal (In) Das Eingabeterminal, das eine Nachricht zur Verarbeitung durch einen Knoten annimmt
Dateibeendigungsterminal Das Eingabeterminal, das eine Nachricht annimmt, welche die endgültige Verarbeitung einer Datei auslöst.
Ausgang Die am Eingangsterminal empfangene Nachricht wird an dieses Terminal weitergegeben, wenn der Datensatz erfolgreich geschrieben wurde. Die Nachricht bleibt bis auf Statusinformationen in der lokalen Umgebung unverändert.
Datenendterminal Die am Dateibeendigungsterminal empfangene Nachricht wird an dieses Terminal weitergegeben, wenn die Datei erfolgreich verarbeitet wurde.
Fehlerterminal (Failure) Das Ausgabeterminal, an das die Nachricht weitergeleitet wird, wenn beim Weitergeben einer Nachricht ein Fehler erkannt wird.

In den folgenden Tabellen werden die Knoteneigenschaften beschrieben, die Sie in einer angegebenen Registerkarte festlegen können. Die Spalte O zeigt an, ob die Eigenschaft obligatorisch ist (im Toolkit mit einem Stern markiert, 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).

Wenn der FTEOutput-Knoten eine Nachricht an das Ausgabe- oder das Datenendeterminal weitergibt, werden die Informationen zu der Nachricht in der Nachrichtenbaumstruktur 'LocalEnvironment.WrittenDestination.FTE' gespeichert. Durch Zusätze zur Nachrichtenbaumstruktur 'LocalEnvironment.Destination.FTE' können Sie den Zielagenten, den Zielwarteschlangenmanager, den Jobnamen, das Zieldateiverzeichnis, den Namen der Zieldatei sowie die Überschreibungsdateien in den Eigenschaften des Zielsystems überschreiben. Weitere Informationen finden Sie im Abschnitt Variablen der lokalen Umgebung mit Dateiknoten verwenden.

Eigenschaften Beschreibung

Eigenschaft O K Standardwert Beschreibung
Knotenname Nein Nein FTEOutput Der Name des Knotens.
Kurzbeschreibung Nein Nein Ohne Kurze Beschreibung des Knotens.
Ausführliche Beschreibung Nein Nein Ohne Text, der den Zweck des Knotens im Nachrichtenfluss beschreibt

Eigenschaften Grundeinstellungen

Eigenschaft O K Standardwert Beschreibung Eigenschaft des Befehls mqsiapplybaroverride
Jobname Nein Ja Ohne Der Name für die Übertragung, der in den Übertragungsprotokollen und Metadaten aufgeführt wird. jobName
Zielagent Nein Ja Ohne Der Name des Zielagenten, an den die Datei gesendet werden soll. Wenn der Zielagent nicht angegeben ist und nicht durch die Baumstruktur 'LocalEnvironment' überschrieben wird, wird standardmäßig der in der Ausführungsgruppe integrierte Agent verwendet. destinationAgent
Zielwarteschlangenmanager Nein Ja Ohne Der Name des Zielwarteschlangenmanagers, an den die Datei gesendet werden soll. destinationQMgr
Zieldateiverzeichnis Nein Ja Ohne Das ferne Verzeichnis, in das der Zielagent die Datei schreibt. destinationDirectory
Zieldateiname Ja Ja Ohne Der genaue Dateiname oder ein Muster mit einem Platzhalterzeichen; definiert den Namen der Datei, die vom Zielagenten erstellt werden soll. destinationFileName
Modus Nein Ja Binäre Übertragung (keine Konvertierung) Der Modus für die Übertragung der Datei. Gültige Werte sind:
  • Binäre Übertragung (keine Konvertierung)
  • Textübertragung (ASCII/EBCDIC und CR/LF automatisiert)
transferMode
Berechnung der MD5-Prüfsumme inaktivieren Ja Ja FALSE Gibt an, ob die Berechnung der MD5-Kontrollsumme für die übertragene Datei inaktiviert ist. checkSumDisabled
Dateien auf Zielsystem überschreiben Ja Ja FALSE Gibt an, ob Dateien auf dem Zielsystem überschrieben werden können, wenn der Zielagent Dateien mit identischen Namen dorthin verschiebt. Wenn der Zielagent eine Datei nicht überschreiben kann, schlägt die Übertragung fehl und wird der Fehler in die Übertragungsprotokolle geschrieben. Der FTEOutput-Knoten selbst gibt keine Fehler aus und protokolliert auch keine Fehler. overwriteDestination

Eigenschaften Anforderung

Eigenschaft O K Standardwert Beschreibung
Datenposition Nein Nein $Body Dies ist die Position in der Baumstruktur der Eingabenachricht, die den Datensatz enthält, der in die Ausgabedatei geschrieben werden soll. Der Standardwert $Body bezieht sich auf die gesamte Nachricht.

Eigenschaften Datensätze und Elemente

Eigenschaft O K Standardwert Beschreibung
Dokumentdefinition Ja Nein Datensatz 'Gesamte Datei' Gibt an, wie Datensätze in die Ausgabedatei gestellt werden. Folgende Optionen sind gültig:
  • Datensatz 'Gesamte Datei'
  • Datensatz 'Nicht geänderte Daten'
  • Datensatz 'Daten mit fester Länge'
  • Datensatz 'Daten mit Begrenzer'
Länge (Bytes) Ja Nein 80 Die erforderliche Länge des Ausgabesatzes. Die Eigenschaft ist nur verfügbar, 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. Die Eigenschaft ist nur verfügbar, wenn unter Datensatzdefinition die Option Datensatz 'Daten mit fester Länge' angegeben ist.
Begrenzer Ja Nein Linienende des Brokersystems Der zu verwendende Begrenzer. Die Eigenschaft ist nur verfügbar, 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) Ja Nein Ohne Die als Begrenzer zu verwendende Bytefolge. Die Eigenschaft ist nur verfügbar, wenn für die Eigenschaft Datensatzdefinition Datensatz 'Daten mit Begrenzer' und für die Eigenschaft Begrenzer Angepasster Begrenzer (hexadezimal) angegeben ist.
Begrenzertyp Ja Nein Postfix Diese Eigenschaft gibt an, wie Begrenzer zwischen Datensätze eingefügt werden. Die Eigenschaft ist nur verfügbar, wenn unter Datensatzdefinition die Option Datensatz 'Daten mit Begrenzer' angegeben ist. Folgende Optionen sind gültig:
  • Postfix
  • Infix

Eigenschaften Auswertung

Eine umfassende Beschreibung dieser Eigenschaften finden Sie unter Auswertungseigenschaften.

Eigenschaft O K Standardwert Beschreibung Eigenschaft des Befehls mqsiapplybaroverride
Auswertung Ja Ja Übernehmen Durch diese Eigenschaft wird gesteuert, ob eine Auswertung stattfindet. Gültige Werte sind:
  • Keine
  • Inhalt und Wert
  • Inhalt
  • Übernehmen
validateMaster
Fehlerbehebungsmaßnahme Ja Nein Ausnahme Durch diese Eigenschaft wird gesteuert, was beim Fehlschlagen der Auswertung geschieht. Die Eigenschaft ist nur verfügbar, wenn Sie Auswerten auf Inhalt oder Inhalt und Wert gesetzt haben. 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:22:39


ReferenzthemaReferenzthema | Version 8.0.0.5 | bc34030_