Datei eines fernen FTP-Verzeichnisses lesen

In diesem Abschnitt finden Sie ein Beispiel zur Verwendung des FileInput-Knotens zum Lesen einer Datei, die sich in einem Verzeichnis auf einem fernen FTP-Server befindet, und zur Weiterleitung von Nachrichten, die auf dem Inhalt dieser Datei basieren.

Bei diesem Beispiel handelt es sich um eine Erweiterung des Beispiels im Abschnitt Datei des lokalen Dateisystems lesen. Es stellt den FileInput-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 einen FileInput-Knoten zu einem Nachrichtenfluss hinzugefügt haben. Außerdem muss sichergestellt sein, dass folgende Ressourcen verfügbar sind:
  • Ein FTP-Server. Stellen Sie sicher, dass ein FTP-Server mit den folgenden Einstellungen vorhanden ist:
    Server
    ftpserver.hursley.abc.com
    Port
    21
    Arbeitsverzeichnis
    /ftpfileinput
    Benutzer-ID
    myuserid
    Password
    mypassword
    Diese Werte dienen nur zu Demonstrationszwecken in diesem Beispiel. Falls Sie andere Werte verwenden möchten, sollten Sie sich diese notieren, um sie im nachfolgenden Beispiel richtig einsetzen zu können. Im Beispiel werden die oben aufgeführten Werte verwendet.
  • Eine Sicherheitsidentität. Definieren Sie mit dem Befehl mqsisetdbparms eine Sicherheitsidentität für die oben angegebenen Benutzer- und Kennwortdaten, und nennen Sie diese Identität für dieses Beispiel myidentity. Verwenden Sie also beispielsweise für einen Broker MyBroker folgenden Befehl:
        mqsisetdbparms MyBroker -n ftp::myidentity -u myuserid -p mypassword
    Achten Sie auf das Präfix ftp::. Dieses ist erforderlich, damit die Dateiknoten die Definition der Sicherheitsidentität finden.
  • Eine Eingabedatei. Um diesem Beispielszenario folgen zu können, sollten Sie eine Eingabedatei mit dem Namen test_input1.xml und folgendem Inhalt erstellen:
    <Message>test1</Message>
    <Message>testzwei</Message>
    <Message>testdrei</Message>
    Jede Zeile muss mit dem Zeilenbegrenzer des Systems enden, auf dem sich der FTP-Server befindet. Legen Sie diese Datei nicht im Eingabeverzeichnis ab, sondern stellen Sie sie in das Verzeichnis /ftpfileinput auf dem FTP-Server.
  • Eine Nachrichtengruppe. In diesem Beispiel wird eine Nachrichtengruppe namens xml1 verwendet, die den XMLNSC-Parser verwendet. Die Nachrichtengruppe xml1 modelliert Nachrichten mit dem folgenden Format:
    <Message>...</Message>

Führen Sie folgende Schritte aus, wenn alle erforderlichen Ressourcen verfügbar sind:

  1. Legen Sie für den FileInput-Knoten die erforderlichen Knoteneigenschaften fest. In der folgenden Tabelle finden Sie eine Zusammenfassung der zu definierenden FileInput-Knoteneigenschaften. Hier ist auch angegeben, auf welcher Registerkarte diese Eigenschaften aufgeführt sind, ob es sich um obligatorische Eigenschaften handelt und welcher Wert in diesem Beispiel festgelegt werden muss:
    Tabelle 1.
    Tabulator Eigenschaft Value
    Grundeinstellung Eingabeverzeichnis C:\FileInput\TestDir
    Dateiname oder Muster test_input1.xml
    Maßnahme bei erfolgreicher Verarbeitung In Unterverzeichnis des Archivs verschieben
    Doppelt vorhandene Archivdateien ersetzen Ausgewählt
    Syntaxanalyse der Eingabenachricht Nachrichtendomäne XMLNSC
    Nachrichtengruppe xml1
    Abfrage Abfrageintervall 3
    Wiederholung Maßnahme bei fehlschlagender Datei Zeitmarke hinzufügen und in Unterverzeichnis für Zurücksetzung verschieben
    Datensätze und Elemente Datensatzerkennung Mit Begrenzer
    Begrenzer DOS- oder UNIX-Linienende
    Begrenzertyp Postfix
    FTP FTP Ausgewählt
    FTP-Server und -Port ftpserver.hursley.abc.com
    Sicherheitsidentität myidentity
    Serververzeichnis /ftpfileinput
    Übertragungsmodus ASCII
    Scan-Verzögerung 45
    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 des lokalen Dateisystems lesen, 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 des lokalen Dateisystems lesen. Die FTP-Eigenschaften bleiben dann zwar eingestellt, sind aber inaktiviert.
  2. Implementieren Sie den Nachrichtenfluss auf dem Broker.
Bei der Ausführung dieser Schritte geschieht Folgendes:
  1. Die Datei test_input1.xml wird aus dem Verzeichnis auf dem FTP-Server (/ftpfileinput) in das lokale Verzeichnis (C:\FileInput\TestDir) übertragen. Danach wird die Datei aus dem Verzeichnis auf dem FTP-Server gelöscht.
  2. Entsprechend der Einstellungen der Eigenschaften auf der Registerkarte Datensätze und Elemente erkennt der FileInput-Knoten Datensätze auf Basis von DOS- oder UNIX-Zeilenendezeichen und erstellt für jeden gefundenen Datensatz eine eigene Nachricht. Er leitet die folgenden drei Nachrichten an den Nachrichtenfluss des Ausgangsterminals weiter:
    • Nachricht 1:
      <Message>test1</Message>
    • Nachricht 2:
      <Message>testzwei</Message>
    • Nachricht 3:
      <Message>testdrei</Message>
  3. Da das Kontrollkästchen FTP aktiviert ist, überlagert die FTP-Scanverzögerung von 45 Sekunden das Abfrageintervall von 3 Sekunden.
  4. Falls dem Datenendterminal ein Knoten zugeordnet ist, wird die Nachricht 'Datenende' nach erfolgter Verarbeitung des letzten Datensatzes in der Datei weitergegeben.
  5. Nach Beendigung der Verarbeitung wird die Datei test_input1.xml in das Archivverzeichnis 'mqsiarchive' (C:\FileInput\TestDir\mqsiarchive\test_input1.xml) verschoben. Falls das Archivverzeichnis 'mqsiarchive' bereits eine Datei namens test_input1.xml enthält, wird diese durch die neue Datei überschrieben.
  6. Im Falle eines Scheiterns des Nachrichtenflusses wird versucht, die Verarbeitung unter Berücksichtigung der für die Eigenschaften des FileInput-Knotens festgelegten Werte zu wiederholen. In diesem Beispielvorgang wird dem Dateinamen eine Zeitmarke hinzugefügt, und die Datei wird in das Verzeichnis 'mqsibackout' verschoben. Hier ein Beispiel für den Pfad einer solchen Datei: C:\FileInput\TestDir\mqsibackout\20070928_150234_171021_test_input1.xml.
Wenn Sie wissen möchten, wie sich andere Einstellungskombinationen der Eigenschaften Datensatzerkennung, Begrenzer und Begrenzertyp des FileInput-Knotens auswirken, fahren Sie mit dem Abschnitt Datei lesen, Auswirkungen verschiedener Werte für die Eigenschaft Datensatzerkennung des FileInput-Knotens fort.
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 des lokalen Dateisystems lesen
Datei auf einen fernen FTP-Server schreiben
Zugehörige Verweise
Datensätze erkennen, die syntaktisch analysiert werden sollen
FileInput-Knoten
Datei lesen, Auswirkungen verschiedener Werte für die Eigenschaft Datensatzerkennung des FileInput-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
ac55422_