In diesem Abschnitt finden Sie ein Beispiel zur Verwendung des FileOutput-Knotens zum Schreiben einer Datei in ein Verzeichnis auf einem fernen FTP-Server. Es zeigt, wie Sie mit einer möglichen Einstellungskombination der Eigenschaften Datensatzdefinition, Begrenzer und Begrenzertyp aus mehreren Nachrichten eine Datei erstellen.
Bei diesem Beispiel handelt es sich um eine Erweiterung des Beispiels im Abschnitt
Datei in das lokale Dateisystem schreiben. Es stellt den
FileOutput-Knoten in einem Beispielnachrichtenfluss dar. Es wird davon ausgegangen, dass alle anderen Teile des Nachrichtenflusses bereits entwickelt sind und dass ein
Windows-System verwendet wird. Sie können den in dem Beispiel beschriebenen Vorgang erst ausführen, nachdem Sie einem Nachrichtenfluss einen
FileOutput-Knoten hinzugefügt haben. Außerdem muss sichergestellt sein, dass folgende Ressourcen verfügbar sind:
Führen Sie folgende Schritte aus, wenn alle erforderlichen Ressourcen verfügbar sind:
- Legen Sie für den FileOutput-Knoten die erforderlichen Knoteneigenschaften fest. In der folgenden Tabelle finden Sie eine Zusammenfassung der erforderlichen FileOutput-Knoteneigenschaften. Hier ist auch angegeben, auf welcher Registerkarte diese Eigenschaften aufgeführt sind und welcher Wert in diesem Beispiel festgelegt werden muss:
Tabelle 1. | Tabulator |
Eigenschaft |
Value |
| Grundeinstellung |
Verzeichnis |
C:\FileOutput\TestDir |
| Dateiname oder Muster |
test_output1.xml |
| Maßnahme für Ausgabedatei |
Zeitmarke, bestehende Datei archivieren und ersetzen (oder erstellen, falls keine Datei vorhanden) |
| Doppelt vorhandene Archivdateien ersetzen |
Ausgewählt |
| Datensätze und Elemente |
Datensatzdefinition |
Datensatz 'Daten mit Begrenzer' |
| Begrenzer |
Linienende des Brokersystems |
| Begrenzertyp |
Postfix |
| FTP |
FTP |
Ausgewählt |
| FTP-Server und -Port |
ftpserver.hursley.abc.com |
| Sicherheitsidentität |
myidentity |
| Serververzeichnis |
/ftpfileoutput |
| Übertragungsmodus |
ASCII |
| Lokale Datei nach Übertragung behalten |
Ausgewählt |
Falls Sie für Ihre FTP-Serverressource andere Werte eingestellt haben, verwenden Sie diese, statt der hier angegebenen.
Die hier angegebenen Einstellungen sind identisch mit den Einstellungen des Beispiels im Abschnitt Datei in das lokale Dateisystem schreiben, mit der Ausnahme, dass die Eigenschaft FTP ausgewählt wurde und die Registerkarte FTP nun Eigenschaften enthält. Wenn Sie das Kontrollkästchen FTP inaktivieren, verhält sich der Knoten wie im Beispiel im Abschnitt Datei in das lokale Dateisystem schreiben. Die FTP-Eigenschaften bleiben dann zwar eingestellt, sind aber inaktiviert.
- Implementieren Sie den Nachrichtenfluss auf dem Broker.
- Senden Sie die ersten drei Nachrichten an das Eingangsterminal des FileOutput-Knotens.
- Senden Sie die abschließende Nachricht an das Dateibeendigungsterminal des FileOutput-Knotens.
Bei der Ausführung dieser Schritte geschieht Folgendes:
- Die Datei wird verarbeitet. Der FileOutput-Knoten generiert entsprechend der Einstellungen seiner Eigenschaften einen Datensatz pro Nachricht, von denen jeder mit einem Zeilenbegrenzer des lokalen Dateisystems endet. Die generierte Datei enthält folgende Daten, wobei jede Zeile mit einem Zeilenbegrenzer endet. Auf einem Windows-System ist dies ein Rücklaufzeichen (X'0D') gefolgt von einem Zeilenvorschubzeichen (X'0A'):
<Message>test1</Message>
<Message>testzwei</Message>
<Message>testdrei</Message>
.
- Die Datensätze werden in einer Datei im Durchgangsverzeichnis C:\FileOutput\TestDir\mqsitransit akkumuliert.
Die Datei hat den Namen test_output1.xml. Weil das Kontrollkästchen FTP aktiviert ist, wird die fertig gestellte Datei, sobald die abschließende Nachricht beim Dateibeendigungsterminal eingeht, auf dem fernen FTP-Server unter /ftpfileoutput/test_output1.xml abgelegt.
- Falls in diesem Verzeichnis auf dem fernen FTP-Server bereits eine Datei mit demselben Namen vorhanden ist, wird die vorhandene Datei überschrieben.
Wenn der ferne FTP-Server nicht auf einem Windows-System ausgeführt wird und die Eigenschaft Übertragungsmodus auf ASCII gesetzt ist, kann es sein, dass die Zeichencodierung und die Zeilenbegrenzerzeichen nach der Übertragung geändert werden. Zum Beispiel wird auf einem FTP-Server unter z/OS ASCII-Text normalerweise in EBCDIC konvertiert, und das Zeilenbegrenzer-Zeichenpaar wird durch das Neue-Zeilen-Zeichen von EBCDIC (X'15') ersetzt. Die Konvertierung von ASCII-Zeichen auf anderen FTP-Servern weicht hiervon eventuell ab.
C:\FileOutput\TestDir\mqsiarchive\20070924_155346_312030_test_output.xml
Ist in diesem Archivverzeichnis bereits eine Datei mit diesem Namen vorhanden, wird diese entsprechend den an dem
FileOutput-Knoten ausgewählten Eigenschaften überschrieben.
- Da das Kontrollkästchen Lokale Datei nach Übertragung behalten aktiviert ist, wird die Datei auf dem lokalen System nicht gelöscht. Allerdings wird sie aus dem Durchgangsverzeichnis 'mqsitransit' in das Ausgabeverzeichnis C:\FileOutput\TestDi verschoben.
Falls bereits eine Datei mit demselben Namen im Ausgabeverzeichnis vorhanden ist, wird die vorhandene Datei umbenannt und in das Archivverzeichnis 'mqsiarchive' verschoben. Die archivierte Datei kann beispielsweise unter dem Pfad
C:\FileOutput\TestDir\mqsiarchive\20070924_155346_312030_test_output1.xml
gespeichert werden. Falls das Archivverzeichnis bereits eine Datei mit diesem Namen enthält, wird die vorhandene Datei entsprechend der Einstellung der Eigenschaft Doppelt vorhandene Archivdateien ersetzen des FileOutput-Knotens überschrieben.
Beachten Sie nun die Informationen im Abschnitt
Datei schreiben, Auswirkungen verschiedener Werte für die Eigenschaft Datensatzdefinition des FileOutput-Knotens, und stellen Sie fest, welche Ergebnisse dieser Vorgang bringt, wenn für die Eigenschaften
Datensatzdefinition,
Begrenzer
und
Begrenzertyp des
FileOutput-Knotens verschiedene Werte festgelegt werden.
Auch in den folgenden Abschnitten finden Sie Beispiele zur Verwendung dieses Knotens:
Sie können Beispiele nur anzeigen, wenn Sie das Information Center
verwenden, das im Message Broker Toolkit integriert ist.