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:
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:
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.
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:
|
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:
|
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:
|
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:
|
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:
|
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:
|
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. |