Datei auf einen fernen FTP-Server schreiben

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:
  1. 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.
  2. Implementieren Sie den Nachrichtenfluss auf dem Broker.
  3. Senden Sie die ersten drei Nachrichten an das Eingangsterminal des FileOutput-Knotens.
  4. Senden Sie die abschließende Nachricht an das Dateibeendigungsterminal des FileOutput-Knotens.
Bei der Ausführung dieser Schritte geschieht Folgendes:
  1. 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>
    .
  2. 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.
  3. 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.
  4. 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.
Zugehörige Konzepte
Verarbeitung von Dateien durch den Broker
Zugehörige Tasks
Datei eines fernen FTP-Verzeichnisses lesen
Datei in das lokale Dateisystem schreiben
Zugehörige Verweise
FileOutput-Knoten
Datei schreiben, Auswirkungen verschiedener Werte für die Eigenschaft Datensatzdefinition des FileOutput-Knotens
Konfigurierbare Serviceeigenschaften für den FTP-Server
Bemerkungen | Marken | Downloads | Bibliothek | Unterstützung | Rückmeldung
Copyright IBM Corporation 1999, 2007 Letzte Aktualisierung: Jan 24, 2008
ac55462_