FileInput-Knoten

Mit dem FileInput-Knoten können Sie Nachrichten verarbeiten, die aus Dateien gelesen werden.

Zweck

Aus einer einzigen Datei können eine oder mehrere Nachrichten gelesen werden. Die Nachrichten werden jeweils als separate Nachrichtenflusstransaktion weitergeleitet. Der Teil einer Datei, der eine Nachrichtenflusstransaktion generiert, wird als Datensatz bezeichnet. In einer Datei können ein oder mehrere Datensätze enthalten sein. Die Eigenschaften im Knoten geben an, wie der FileInput-Knoten die Datensätze in einer Datei bestimmt.

Der FileInput-Knoten befindet sich im Ablagefach Datei der Palette und wird in der Workbench durch folgendes Symbol dargestellt:

Symbol für FileInput-Knoten

Dateiverarbeitung

Der FileInput-Knoten liest Dateien aus einem angegebenen Verzeichnis (genannt Eingabeverzeichnis) und leitet auf Basis der Dateiinhalte Nachrichten weiter. Es werden nur Dateien mit Namen gelesen, die einem bestimmten Muster (Eingabemuster) entsprechen.

Sobald die Dateien verarbeitet wurden, werden sie vom FileInput-Knoten aus dem Eingabeverzeichnis gelöscht.

Optional kann der FileInput-Knoten Dateien von einem fernen FTP-Server zur Verarbeitung übertragen. Wenn die ferne Datei erfolgreich übertragen wurde, wird sie vom FTP-Server gelöscht, und die übertragene Kopie wird genau wie eine Datei im Eingabeverzeichnis verarbeitet. Es werden nur Dateien übertragen, die dem Eingabemuster entsprechen.

Der FileInput-Knoten speichert Dateien während und nach der Verarbeitung in Unterverzeichnissen. Alle diese Verzeichnisse beginnen mit dem Präfix mqsi. Zu diesen Verzeichnissen gehören das Archivverzeichnis (mqsiarchive) und das Backoutverzeichnis (mqsibackout).

Nachdem der Nachrichtenfluss die Datei verarbeitet hat, geschieht Folgendes mit der Datei:
  • Die Datei wird gelöscht oder in das Archivverzeichnis verschoben. Dies geschieht, wenn die Verarbeitung erfolgreich war und die Nachrichtenflusstransaktion festgeschrieben wird.
  • Die Datei wird gelöscht oder in das Backoutverzeichnis oder in das Archivverzeichnis verschoben. Dies geschieht, wenn die Verarbeitung fehlgeschlagen ist und die Nachrichtenflusstransaktion zurückgesetzt wird.
Über die Knoteneigenschaften können Sie festlegen, welche dieser Aktionen ausgeführt werden soll.

Datensatzverarbeitung

Eine Datei wird standardmäßig als einzelner Datensatz behandelt und als einzelne Nachricht verarbeitet.

Über die Eigenschaften auf den Knoten können Sie angeben, ob die Eingabedatei in Datensätze aufgeteilt wird, von denen jeder separat verarbeitet wird. Sie können Datensätze wie folgt angeben:
  • Feste Länge. Die Länge der Datensätze beträgt eine bestimmte Anzahl von Bytes, und die Datensätze beginnen mit dem ersten Byte der Datei.
  • Mit Begrenzer. Eine bestimmte Folge von Bytes ist als Begrenzer für Datensätze angegeben. Ein Beispiel für eine solche Folge ist eine Zeilenendefolge.
  • Syntaktisch analysierte Folge. Ein angegebener Nachrichtendomänenparser liest Bytes vom Beginn der Datei, bis eine vollständige Nachricht erkannt wird, die dann verarbeitet wird. Derselbe Parser liest nachfolgende Bytes für die nächste Nachricht und setzt diesen Vorgang fort, bis die gesamte Datei verarbeitet ist.
Nach erfolgreicher Verarbeitung des letzten Datensatzes der Datei wird an das Datenendterminal (falls angeschlossen) eine weitere Nachricht 'Datenende' weitergegeben. Die Nachricht über das Datenende umfasst eine leere BLOB-Nachricht sowie eine Struktur 'LocalEnvironment.File'. Dank der Datenendnachricht ist in einem anderen Teil des Nachrichtenflusses eine explizite Flussendverarbeitung möglich.

Nachrichtenstruktur

Der FileInput-Knoten bearbeitet Nachrichten in den folgenden Nachrichtendomänen:
  • MRM
  • XMLNSC
  • XMLNS
  • DataObject
  • JMSMap
  • JMSStream
  • MIME
  • BLOB (Binary large object)
  • IDOC
  • XML

Wenn der FileInput-Knoten eine Nachricht weitergibt, werden die Informationen in der Nachrichtenbaumstruktur 'LocalEnvironment.File' gespeichert. Wenn die Eingabedatei leer ist, ist auch die Nachricht leer (es wird davon ausgegangen, dass Auswertungen weitergegeben werden). In der folgenden Tabelle ist die Nachrichtenbaumstruktur von 'LocalEnvironment.File' aufgeführt.

Tabelle 1.
Elementname Elementdatentyp Beschreibung
Directory CHARACTER Absoluter Verzeichnispfad des Eingabeverzeichnisses in der vom Dateisystem des Brokers verwendeten Form. Auf Windows-Systemen beispielsweise beginnt der Verzeichnispfad mit dem Laufwerkbuchstabenpräfix (z. B. C:).
Name CHARACTER Dateiname und Erweiterung.
LastModified TIMESTAMP Datum und Uhrzeit der letzten Änderung.
TimeStamp CHARACTER Der Zeitpunkt (Datum und Uhrzeit), zu dem der Empfangsknoten die Verarbeitung der Datei in der UTC-Zone gestartet hat, als Zeichenfolge. Anhand dieser Daten werden die Namen von Archiv- und Backout-Dateien erstellt, wenn diese Namen eine Zeitmarke enthalten.
Die folgenden Elemente enthalten Daten zu dem aktuellen Datensatz:
Offset INTEGER (Ganze Zahl) Start des Datensatzes in der Datei. Der erste Datensatz startet bei Offset 0. Ist das Element Teil einer Nachrichtenbaumstruktur 'Datenende', ist hier die Länge der Eingabedatei angegeben.
Record INTEGER (Ganze Zahl) Datensatznummer in der Datei. Der erste Datensatz startet bei Satznummer 1. Ist das Element Teil der Nachrichtenbaumstruktur 'Datenende', ist hier die Anzahl der Datensätze angegeben.
Begrenzer CHARACTER Die Zeichen, die zur Trennung dieses Datensatzes vom vorangehenden Datensatz verwendet werden, wenn für Datensatzerkennung Mit Begrenzer angegeben ist. Der erste Datensatz hat einen Begrenzer von null. Ist das Element Teil der Nachrichtenbaumstruktur 'Datenende', ist hier der auf den letzten Datensatz folgende Begrenzer angegeben, falls vorhanden.
IsEmpty BOOLEAN Gibt an, ob der vom Nachrichtenfluss weitergeleitete Datensatz leer ist. Der Parameter ist auf TRUE gesetzt, wenn der aktuelle Datensatz leer ist. Als Teil der Datenende-Nachrichtenbaumstruktur ist der Parameter immer auf TRUE gesetzt.

Diesen Knoten in einem Nachrichtenfluss verwenden

Der FileInput-Knoten kann in jedem Nachrichtenfluss verwendet werden, der Nachrichten in Dateien annehmen muss. Die folgenden Beispielprogramme verdeutlichen die Verwendung dieses Knotens:
Sie können Beispiele nur anzeigen, wenn Sie das Information Center verwenden, das im Message Broker Toolkit integriert ist.

FileInput-Knoten konfigurieren

Nachdem Sie eine Instanz des FileInput-Knotens in einen Nachrichtenfluss eingereiht haben, können Sie den Knoten konfigurieren; siehe Nachrichtenflussknoten konfigurieren. Die Knoteneigenschaften werden in der Eigenschaftenansicht angezeigt. Alle verbindlichen Eigenschaften, für die Sie einen Wert eingeben müssen (d. h. Eigenschaften ohne definierten Standardwert), sind mit einem Sternchen gekennzeichnet.

Konfigurieren Sie den FileInput-Knoten:

  1. Optional: Geben Sie auf der Registerkarte Beschreibung eine Kurzbeschreibung und/oder eine Ausführliche Beschreibung ein. Sie können den Knoten dort auch umbenennen.
  2. Geben Sie auf der Registerkarte Grundeinstellung die Verzeichnisse und Dateien ein, die von dem FileInput-Knoten verarbeitet werden sollen, und legen Sie außerdem fest, was mit doppelt vorhandenen Dateien geschehen soll.
    1. Geben Sie unter Eingabeverzeichnis das Verzeichnis an, aus dem der FileInput-Knoten Dateien erhält. Sie können für das Verzeichnis einen absoluten oder einen relativen Verzeichnispfad angeben. Ein relativer Verzeichnispfad wird in Bezug auf das in der Umgebungsvariablen MQSI_FILENODES_ROOT_DIRECTORY angegebene Verzeichnis angegeben. Ein Beispiel unter Windows: C:\fileinput. Ein Beispiel unter UNIX: /var/fileinput.
    2. Geben Sie unter Dateiname oder Muster einen Dateinamen bzw. ein Muster an. Hierbei kann es sich entweder um einen Dateinamen oder um eine mit einem Dateinamen übereinstimmende Zeichenfolge (ein Muster) handeln. Ein Muster ist eine Zeichenfolge mit mindestens einem der folgenden Platzhalterzeichen:
      Platzhalterzeichen Beschreibung Beispiel
      * Beliebige Folge von null oder mehr Zeichen *.xml stimmt mit allen Dateinamen überein, deren Erweiterung xml lautet.
      ? Beliebiges einzelnes Zeichen f??????.csv stimmt mit allen Dateinamen überein, die mit dem Buchstaben f beginnen, sechs weitere Zeichen umfassen und die Erweiterung .csv haben.
      Es werden nur die Dateien aus dem Eingabeverzeichnis verarbeitet, deren Namen mit dem Muster übereinstimmen.
    3. Wählen Sie Maßnahme bei erfolgreicher Verarbeitung aus, und geben Sie an, wie der FileInput-Knoten nach erfolgreicher Verarbeitung der Datei vorgehen soll. Hierbei sind folgende Maßnahmen möglich: die Datei kann in das Archivunterverzeichnis verschoben werden, der Dateiname kann mit einer Zeitmarke erweitert und die Datei dann in das Archivunterverzeichnis verschoben werden, oder aber die Datei kann gelöscht werden.
      • Wenn Sie In Unterverzeichnis des Archivs verschieben auswählen, wird die Datei in das Unterverzeichnis des Archivs des Eingabeverzeichnisses verschoben. Der Name des Unterverzeichnisses lautet mqsiarchive. Wenn beispielsweise /var/fileinput das überwachte Verzeichnis ist, lautet der absolute Pfad des Unterverzeichnisses /var/fileinput/mqsiarchive. Wenn dieses Verzeichnis nicht vorhanden ist, wird es vom Broker beim ersten Versuch, eine Datei in das Verzeichnis zu verschieben, erstellt.
      • Bei Auswahl von Zeitmarke hinzufügen und in Unterverzeichnis des Archivs verschieben wird der Dateiname um das aktuelle Datum und die aktuelle Uhrzeit erweitert, und anschließend wird die Datei in das Verzeichnis mqsiarchive verschoben.
      • Bei Auswahl von Löschen wird die Datei nach erfolgreicher Verarbeitung gelöscht.
      Wenn die Tracefunktion für Benutzer aktiviert ist, schreibt der FileInput-Knoten jedes Mal, wenn er eine Datei verarbeitet, eine Nachricht in den Benutzertrace.
    4. Wählen Sie Doppelt vorhandene Archivdateien ersetzen aus, wenn eine Datei im Archivunterverzeichnis durch eine erfolgreich verarbeitete Datei mit demselben Namen ersetzt werden soll. Wenn Sie diese Option nicht festlegen und in dem Archivunterverzeichnis bereits eine Datei mit demselben Namen vorhanden ist, wird der Knoten beim Versuch, die erfolgreich verarbeitete Datei zu verschieben, eine Ausnahme ausgeben.
  3. Legen Sie auf der Registerkarte Syntaxanalyse der Eingabenachricht Werte für die Eigenschaften fest, anhand derer der Knoten feststellt, wie die eingehende Nachricht analysiert werden soll.
    1. Wählen Sie in der Liste unter Nachrichtendomäne den Namen des von Ihnen verwendeten Parsers aus. Der Standardwert ist BLOB. Folgende Optionen stehen zur Auswahl:
      • MRM
      • XMLNSC
      • XMLNS
      • DataObject
      • JMSMap
      • JMSStream
      • MIME
      • BLOB (Binary large object)
      • IDOC
      • XML
    2. Wählen Sie bei Verwendung des MRM- oder IDOC-Parsers oder des XMLNSC-Parsers im Prüfungsmodus die zu verwendende Nachrichtengruppe aus. Diese Liste wird mit verfügbaren Nachrichtengruppen gefüllt, wenn Sie MRM, XMLNSC oder IDOC als Domäne auswählen.
    3. Wenn Sie den MRM-Parser verwenden, wählen Sie aus der Liste unter Nachrichtentyp den korrekten Nachrichtentyp aus. Diese Liste wird mit verfügbaren Nachrichtentypen aufgefüllt, wenn Sie den MRM-Parser auswählen.
    4. Wählen Sie bei Verwendung des MRM- oder IDOC-Parsers in der Liste unter Nachrichtenformat das korrekte Nachrichtenformat aus. Bei Auswahl des MRM- oder IDOC-Parsers werden in dieser Liste die verfügbaren Nachrichtenformate aufgeführt.
    5. Geben Sie in ID des codierten Nachrichtensatzes die ID des codierten Nachrichtensatzes an.
    6. Wählen Sie aus der Liste unter Nachrichtencodierung die Nachrichtencodierung aus, oder geben Sie einen numerischen Codierungswert ein. Weitere Informationen zur Codierung finden Sie unter Daten mit Nachrichtenflüssen konvertieren.
  4. Auf der untergeordneten Registerkarte Parser-Optionen gilt Folgendes:
    1. Die Option Zeitpunkt für Syntaxanalyse ist standardmäßig auf Bei Bedarf gesetzt. Dies führt dazu, dass die Syntaxanalyse der Nachricht verzögert wird. Wenn die Syntaxanalyse sofort ausgeführt werden soll, lesen Sie den Abschnitt Bedarfsgerechte Syntaxanalyse.
    2. Legen Sie bei Verwendung des XMLNSC-Parsers Werte für die Eigenschaften fest, die die Funktionsweise des XMLNSC-Parsers bestimmen. Der Abschnitt Nachrichten in der XMLNSC-Domäne bearbeiten enthält weitere Informationen hierzu.
  5. Geben Sie auf der Registerkarte Abfrage das Abfrageintervall des FileInput-Knotens ein. Über diese Eigenschaft wird gesteuert, wie oft der FileInput-Knoten auf das Dateisystem zugreift, um nach zu verarbeitenden Dateien zu suchen.

    Nach dem anfänglichen Suchlauf für das Verzeichnis beim Starten des Nachrichtenflusses wartet der FileInput-Knoten jeweils einen gewissen durch diese Eigenschaft definierten Zeitraum, wenn in dem Verzeichnis keine dem Eingabemuster entsprechenden Dateien gefunden werden. Somit muss der FileInput-Knoten nicht fortwährend auf das Dateisystem zugreifen, ein Vorgang, bei dem umfangreiche Systemressourcen benötigt werden.

    Je kleiner der für diese Eigenschaft festgelegte Wert, desto schneller erkennt der FileInput-Knoten Dateien im Eingabeverzeichnis. Allerdings werden dafür mehr Systemressourcen benötigt. Wenn ein größerer Wert definiert ist, sind weniger Systemressourcen erforderlich, jedoch werden zu verarbeitende Dateien vom FileInput-Knoten später erkannt.

    Diese Eigenschaft sollte nicht zur Arbeitsregulierung oder zur Verarbeitungsplanung eingesetzt werden. Wenn der FileInput-Knoten das Eingabeverzeichnis nur zu bestimmten Zeiten überwachen soll, sollten Sie den Nachrichtenfluss zu den entsprechenden Zeiten starten und stoppen.

    Wenn Sie FTP-Verarbeitung auswählen und die Eigenschaft Scan-Verzögerung auf der Registerkarte 'FTP' einstellen, überschreibt dieser Wert die Einstellung für das Abfrageintervall.

  6. Auf der Registerkarte Wiederholung können Sie die Wiederholungsverarbeitung definieren, wenn ein Fluss fehlschlägt. Sie können folgende Einstellungen vornehmen:
    1. Über die Option Wiederholungsmechanismus wird festgelegt, welche Aktion im Falle eines Scheiterns des Nachrichtenflusses ausgeführt werden soll. Folgende Optionen stehen zur Auswahl:
      • Wählen Sie Fehler aus, wenn der Knoten einen Fehler melden, jedoch keine Wiederholungsversuche starten soll.
      • Wählen Sie Kurze Wiederholungszeit aus, wenn der Knoten bei Fortbestehen der Bedingung einen Wiederholungsversuch starten soll, bevor ein Fehler gemeldet wird. Wie oft eine Wiederholung erfolgt, ist durch den Wiederholungsschwellenwert festgelegt.
      • Wählen Sie Short retry and long retry (Kurze und lange Wiederholungszeit) aus, wenn der Knoten zunächst die unter Wiederholungsschwellenwert angegebene Anzahl an Wiederholungsversuchen in kurzen Abständen starten soll. Falls das Problem auch nach Erreichen des Wiederholungsschwellenwerts bestehen bleibt, wartet der Knoten zwischen den einzelnen Versuchen den unter Langes Wiederholungsintervall angegebenen Zeitraum.
    2. Geben Sie den Wiederholungsschwellenwert an. Die Anzahl der Wiederholungsversuche, die der Knoten für die Nachrichtenflusstransaktion startet, wenn die Eigenschaft Wiederholungsmechanismus auf Kurze Wiederholungszeit oder Short retry and long retry (Kurze und lange Wiederholungszeit) gesetzt ist.
    3. Geben Sie das kurze Wiederholungsintervall an. Dies ist die Zeitspanne in Sekunden zwischen den Versuchen mit kurzer Wiederholungszeit.
    4. Geben Sie das lange Wiederholungsintervall an. Dieser Wert gibt an, wie lange zwischen den einzelnen Versuchen mit langer Wiederholungszeit gewartet werden soll, bis eine Nachricht erfolgreich ist, der Nachrichtenfluss gestoppt oder erneut implementiert wird. Über die Brokereigenschaft MinLongRetryInterval wird der Mindestwert für das lange Wiederholungsintervall definiert. Wenn der Wert diesen Mindestwert unterschreitet, wird der Brokerwert verwendet.
    5. Geben Sie die Maßnahme bei fehlschlagender Datei an. Mit diesem Wert wird festgelegt, was der Knoten mit der Eingabedatei machen soll, wenn alle Versuche, den Dateiinhalt zu verarbeiten, fehlgeschlagen sind. Folgende Optionen stehen zur Auswahl:
      • In Unterverzeichnis für die Zurücksetzung verschieben. Die Datei wird in das Unterverzeichnis für die Zurücksetzung im Eingabeverzeichnis verschoben. Der Name dieses Unterverzeichnisses lautet mqsibackout. Bei einem Eingabeverzeichnis /var/fileinput z. B. lautet der absolute Pfad des Unterverzeichnisses für die Zurücksetzung /var/fileinput/mqsibackout. Wenn dieses Unterverzeichnis nicht vorhanden ist, wird es vom Broker beim ersten Versuch, eine Datei in das Verzeichnis zu verschieben, erstellt. Falls die Datei nicht in dieses Unterverzeichnis verschoben werden kann, weil zum Beispiel bereits eine Datei mit dem gleichen Namen im Verzeichnis vorhanden ist, fügt der Knoten dem Dateinamen das aktuelle Datum und die Uhrzeit hinzu und unternimmt einen zweiten Versuch, die Datei zu verschieben. Wenn auch dieser zweite Versuch fehlschlägt, beendet der Knoten die Verarbeitung. In diesem Fall werden die Nachrichten BIP3331 und BIP3325 ausgegeben. Die Hinweise dieser Nachrichten (Unterverzeichnis oder Datei) helfen Ihnen bei der Lösung des Problems, bevor Sie den Nachrichtenfluss erneut starten.
      • Löschen. Die Datei wird nach einem Fehlschlagen der Verarbeitung gelöscht.
      • Zeitmarke hinzufügen und in Unterverzeichnis für Zurücksetzung verschieben. Dem Dateinamen werden das aktuelle Datum und die aktuelle Uhrzeit hinzugefügt, und anschließend wird die Datei in das Verzeichnis für die Zurücksetzung verschoben.
  7. Geben Sie auf der Registerkarte Datensätze und Elemente an, wie die einzelnen Dateien als Datensätze interpretiert werden:
    • Geben Sie mit der Eigenschaft Datensatzerkennung an, wie die Datei in Datensätze aufgeteilt wird, aus denen dann die einzelnen Nachrichten generiert werden. Folgende Optionen stehen zur Auswahl:
      • Gesamte Datei - die gesamte Datei bildet einen einzigen Datensatz.
      • Feste Länge - jeder Datensatz umfasst eine festgelegte Anzahl Bytes. Die einzelnen Datensätze sollten die in der Eigenschaft Länge angegebene Bytezahl aufweisen, lediglich der letzte Datensatz in der Datei kann möglicherweise kürzer sein.
      • Wählen Sie Mit Begrenzer aus, wenn die verarbeiteten Datensätze durch ein DOS- oder UNIX-Linienende bzw. durch eine Folge benutzerdefinierter Begrenzerbytes getrennt bzw. beendet werden. Geben Sie für die Eigenschaften Begrenzer und Begrenzertyp den Begrenzer und den Begrenzertyp an.
      • Wählen Sie die Option Syntaktisch analysierte Folge aus, wenn die Datei eine Folge von einem oder mehreren Datensätzen enthält, die von dem unter Nachrichtendomäne angegebenen Parser seriell erkannt werden. Die einzelnen erkannten Datensätze werden vom Knoten jeweils als separate Nachrichten weitergegeben. Die einzelnen erkannten Datensätze werden vom Knoten jeweils als separate Nachrichten weitergegeben. Bei Auswahl dieser Datensatzerkennungsoption muss unter Nachrichtendomäne entweder ein XMLNSC- oder ein MRM-Parser angegeben sein (das physische Format muss CWF oder TDS sein).
    • Wenn Sie unter Datensatzerkennung Feste Länge angeben, müssen Sie unter Länge die erforderliche Länge des Ausgabesatzes eingeben. Dieser Wert muss zwischen 1 Byte und 100 MB liegen. Der Standardwert beträgt 80 Bytes.

      Wenn Sie unter Datensatzerkennung die Option Gesamte Datei, Feste Länge oder Mit Begrenzer angeben, gilt für die Datensätze eine Längenbeschränkung von 100 MB. Wenn Sie unter Datensatzerkennung die Option Syntaktisch analysierte Folge angeben, führt der FileInput-Knoten keine Ermittlung der Datensatzlänge durch und beschränkt diese auch nicht. Die im Nachrichtenfluss nachgeordneten Knoten können die Datensatzlänge entweder ermitteln oder sehr lange Datensätze verarbeiten. Wenn lange Datensätze auf diese Weise verarbeitet werden sollen, müssen Sie sicherstellen, dass Ihr Broker über ausreichend Arbeitsspeicher verfügt. Eventuell müssen Sie die im Beispiel für umfangreiche Nachrichtenausgaben beschriebenen Nachrichtenflusstechniken anwenden, um den verfügbaren Arbeitsspeicher optimal zu nutzen.

    • Wenn Sie unter Datensatzerkennung Mit Begrenzer angeben, müssen Sie unter Begrenzer den zu verwendenden Begrenzer angeben. Zur Auswahl stehen:
      • DOS- oder UNIX-Linienende: Diese Option gibt auf UNIX-Systemen das Zeilenvorschubzeichen (<LF>, X'0A') und auf Windows-Systemen ein Rücklaufzeichen gefolgt von einem Zeilenvorschubzeichen (<CR><LF>, X'0D0A') an. Der Knoten behandelt beide Zeichenfolgen als Begrenzer, unabhängig davon, auf welchem System der Broker ausgeführt wird. Falls beide Zeichenfolgen in der gleichen Datei verwendet werden, erkennt der Knoten beide als Begrenzer. X'15' wird vom Knoten hingegen nicht erkannt. Diese Zeichenfolge steht auf z/OS-Systemen für das Neue-Zeilen-Byte. Wenn Ihre Eingabedatei mit der EBCDIC-Zeichenfolge für neue Zeilen codiert ist, wie dies beispielsweise bei EBCDIC-Dateien von z/OS-Systemen der Fall ist, müssen Sie für diese Eigenschaft den Wert Angepasster Begrenzer sowie für die Eigenschaft Angepasster Begrenzer den Wert 15 angeben.
      • Angepasster Begrenzer: Hier können Sie für Angepasster Begrenzer eine Bytefolge angeben.
    • Geben Sie unter Angepasster Begrenzer das bzw. die Begrenzerbyte(s) an, das/die verwendet werden soll(en), wenn für die Eigenschaft Begrenzer die Option Angepasster Begrenzer festgelegt ist. Geben Sie diesen Wert als geradzahlige Zeichenfolge mit Hexadezimalziffern an. Der Standardwert ist X'0A', die maximale Länge der Zeichenfolge beträgt 16 Bytes (dargestellt durch 32 Hexadezimalziffern).
    • Wenn Sie unter Datensatzerkennung Mit Begrenzer angeben, müssen Sie unter Begrenzertyp den zu verwendenden Begrenzertyp angeben. Gültige Werte sind:
      • Infix. Bei Auswahl dieses Wertes wird jeder Begrenzer zum Trennen von Datensätzen eingesetzt. Wenn die Datei mit einem Begrenzer endet, wird der Dateiinhalt (der Länge null) nach dem letzten Begrenzer ebenfalls weitergegeben, obwohl er keine Daten enthält.
      • Postfix. Bei Angabe dieses Wertes wird jeder Begrenzer zum Beenden von Datensätzen eingesetzt. Wenn die Datei mit einem Begrenzer endet, wird kein leerer Datensatz nach dem Begrenzer weitergegeben. Endet die Datei nicht mit einem Begrenzer, so wird sie genauso verarbeitet, wie wenn den letzten Bytes der Datei ein Begrenzer folgen würde. Postfix ist der Standardwert.
    • Der FileInput-Knoten sieht jedes Vorkommen des Begrenzers in der Eingabedatei als trennenden Begrenzer (Infix) oder beendenden Begrenzer (Postfix) für die einzelnen Datensätze an. Wenn die Datei mit einem Begrenzer beginnt, behandelt der Knoten den Dateiinhalt (der Länge null) vor diesem Begrenzer als Datensatz und gibt somit einen leeren Datensatz an den Fluss weiter. Der Begrenzer wird niemals in die weitergegebene Nachricht aufgenommen.
  8. Nehmen Sie über die Registerkarte Auswertung eine Auswertung anhand der Nachrichtengruppe für vordefinierte Nachrichten vor. Weitere Informationen zur Auswertung finden Sie im Abschnitt Nachrichten überprüfen. Informationen zum Ausfüllen dieser Registerkarte finden Sie im Abschnitt Eigenschaften der Registerkarte 'Auswertung'.
  9. Aktivieren Sie auf der Registerkarte FTP das FTP-Kontrollkästchen, wenn der Knoten Dateien von einem FTP-Server unter Verwendung der FTP-Eigenschaften lesen soll.
    • Geben Sie unter FTP-Server und -Port die Internetadresse und die Portnummer des zu verwendenden FTP-Servers an. Verwenden Sie hierbei folgende Syntax:
      • <IP-Adresse oder URL> oder
      • <IP-Adresse oder URL>:<Portnummer>
      Wenn Sie die Internetadresse im IPv6-Format angeben, muss diese in eckigen Klammern eingeschlossen sein. Beispiel:
      • [12a::13bd:24cd] oder
      • [12a::13bd:24cd]:123, wobei 123 für die Portnummer steht
      Wenn Sie keine Portnummer angeben, wird die Portnummer 21 angenommen. Ist allerdings ein konfigurierbarer FTP-Server-Service definiert, können Sie den Namen des konfigurierbaren Service in dieses Feld eingeben. Informationen dazu, inwiefern sich die Definition eines konfigurierbaren FTP-Server-Service und die Eigenschaften auf dieser Registerkarte gegenseitig beeinflussen, finden Sie im Abschnitt Konfigurierbare Serviceeigenschaften für den FTP-Server.
    • Geben Sie unter Sicherheitsidentität den Namen einer über den Befehl mqsisetdbparms definierten Sicherheitsidentität an. Die Benutzer-ID und das Kennwort für die Anmeldung am FTP-Server werden dieser Definition entnommen. Deren Name sollte das Präfix ftp:: aufweisen. Falls die Eigenschaft für die Sicherheitsidentität (securityIdentity) im konfigurierbaren FTP-Server-Service definiert ist, wird der Wert der hier beschriebenen Eigenschaft mit dem dort angegebenen Wert überschrieben.
    • Geben Sie unter Serververzeichnis das Verzeichnis auf dem FTP-Server an, aus dem Dateien übertragen werden sollen. Die Standardeinstellung lautet . und bezeichnet das Standardverzeichnis nach der Anmeldung. Wird hierfür ein relativer Pfad angegeben, basiert das betreffende Verzeichnis auf dem Standardverzeichnis nach der Anmeldung beim FTP-Server. Achten Sie darauf, dass die Pfadsyntax mit den Dateisystemstandards auf dem FTP-Server übereinstimmt. Falls die Eigenschaft 'remoteDirectory' im konfigurierbaren FTP-Server-Service definiert ist, wird der Wert der hier beschriebenen Eigenschaft mit dem dort angegebenen Wert überschrieben.
    • Geben Sie unter Übertragungsmodus an, wie die Dateien übertragen werden. Wählen Sie Binär aus, wenn der Dateiinhalt nicht umgewandelt werden muss. Wählen Sie ASCII aus, wenn die Datei im ASCII-Format übertragen werden soll. Falls die Eigenschaft 'transferMode' im konfigurierbaren FTP-Server-Service definiert ist, wird der Wert der hier beschriebenen Eigenschaft mit dem dort angegebenen Wert überschrieben.
    • Geben Sie unter Scan-Verzögerung an, wie viele Sekunden zwischen den Verzeichnissuchläufen gewartet werden soll. Der Standardwert beträgt 60 Sekunden. Der für diese Eigenschaft festgelegte Wert überschreibt den auf der Registerkarte Abfrage für das Abfrageintervall gesetzten Wert, wenn das Kontrollkästchen 'FTP' markiert ist. Falls die Eigenschaft 'scanDelay' im konfigurierbaren FTP-Server-Service definiert ist, wird der Wert der hier beschriebenen Eigenschaft mit dem dort angegebenen Wert überschrieben.
  10. Definieren Sie auf der Registerkarte Transaktionen den Transaktionsmodus. Zwar sind alle Dateioperationen nicht transaktionsorientiert, der Transaktionsmodus auf diesem Empfangsknoten entscheidet jedoch darüber, ob die übrigen Knoten in dem Fluss unter Verwendung eines Synchronisationspunkts ausgeführt werden oder nicht. Wählen Sie Ja aus, wenn die Flussaktualisierungen nach Möglichkeit transaktionsorientiert behandelt werden sollen, und Nein, wenn nicht. Der Standardwert für diese Eigenschaft lautet Ja.
  11. Optional: Legen Sie auf der Registerkarte Instanzen Werte für die Eigenschaften fest, mit denen die für einen Knoten verfügbaren zusätzlichen Instanzen (Threads) gesteuert werden. Nähere Informationen finden Sie unter Konfigurierbare Nachrichtenflusseigenschaften.

Terminals und Eigenschaften

In der folgenden Tabelle werden die Terminals des FileInput-Knotens beschrieben.

Terminal Beschreibung
Fehlerterminal Das Ausgabeterminal, an das eine Nachricht weitergeleitet wird, wenn im Fall eines Fehlers, bevor eine Nachricht an das Ausgangsterminal weitergegeben werden kann, eine Störung weitergeleitet wird. An dieses Terminal weitergegebene Nachrichten werden nicht ausgewertet. Dies gilt selbst dann, wenn über die Eigenschaft Auswerten angegeben wurde, dass eine Auswertung stattfinden soll.
Ausgang Das Ausgabeterminal, an das die Nachricht geleitet wird, wenn sie erfolgreich aus der Eingabedatei extrahiert wurde. Wenn keine Fehler im Eingabefluss auftreten, wird die von einer externen Ressource empfangene Nachricht immer zuerst an das Ausgabeterminal gesendet.
Datenende Das Ausgabeterminal, an das die Nachricht 'Dateiende' geleitet wird, nachdem alle Nachrichten in einer Datei verarbeitet wurden. Die Nachrichtenflusstransaktion 'Datenende' wird nur initialisiert, wenn dieses Terminal angeschlossen ist.
Catch-Terminal Das Ausgabeterminal, an das die Nachricht geleitet wird, wenn nachgeschaltet eine Ausnahmebedingung ausgegeben und von diesem Knoten abgefangen wurde. Ausnahmen werden nur abgefangen, wenn dieses Terminal angeschlossen ist.

In den folgenden Tabellen werden die Knoteneigenschaften beschrieben. Die Spalte M zeigt an, ob die Eigenschaft obligatorisch ist (markiert mit einem Sternchen, wenn ein Wert eingegeben werden muss, weil kein Standardwert definiert ist). Die Spalte C zeigt an, ob die Eigenschaft konfigurierbar ist (Wert kann geändert werden, wenn der Nachrichtenfluss zur BAR-Datei hinzugefügt wird, um ihn einzusetzen).

In der folgenden Tabelle werden die Beschreibungseigenschaften des FileInput-Knotens beschrieben:

Eigenschaft M C Standardwert Beschreibung
Knotenname Nein Nein FileInput Der Name des Knotens.
Kurzbeschreibung Nein Nein None (Keinen) Kurze Beschreibung des Knotens.
Ausführliche Beschreibung Nein Nein None (Keinen) Text, der den Zweck des Knotens im Nachrichtenfluss beschreibt.

In der folgenden Tabelle werden die grundlegenden Eigenschaften des FileInput-Knotens beschrieben:

Eigenschaft M C Standardwert Beschreibung
Eingabeverzeichnis Ja Ja None (Keinen) Der Pfad des Verzeichnisses, aus dem Eingabedateien verarbeitet werden. Das Verzeichnis befindet sich in dem Dateisystem, auf das der Broker Zugriff hat.
Dateiname oder Muster Ja Ja * Ein Dateiname oder eine Zeichenfolge mit optionalen Platzhalterzeichen (* oder ?) zur Bezeichnung der zu verarbeitenden Datei(en) aus dem Eingabeverzeichnis.
Maßnahme bei erfolgreicher Verarbeitung Ja Nein Löschen Die Maßnamen, die der Knoten nach erfolgreicher Verarbeitung der Inhalte ergreift. Folgende Optionen sind gültig:
  • In Unterverzeichnis des Archivs verschieben
  • Zeitmarke hinzufügen und in Unterverzeichnis des Archivs verschieben
  • Löschen
Doppelt vorhandene Archivdatei ersetzen Ja Nein Nicht ausgewählt Über diese Eigenschaft wird gesteuert, ob der Knoten vorhandene Archivdateien, die denselben Namen wie die Eingabedatei haben, überschreibt. Sie gilt nur, wenn für Maßnahme bei erfolgreicher Verarbeitung nicht Löschen angegeben ist.

In der folgenden Tabelle werden die Eigenschaften von 'Syntaxanalyse der Eingabenachricht' des FileInput-Knotens beschrieben.

Eigenschaft M C Standardwert Beschreibung
Nachrichtendomäne Nein Nein   Die Domäne für die Syntaxanalyse der ankommenden Nachricht.
Nachrichtengruppe Nein Nein   Der Name oder die ID der Nachrichtengruppe, in der die ankommende Nachricht definiert ist.
Nachrichtenart Nein Nein   Der Name der ankommenden Nachricht.
Nachrichtenformat Nein Nein   Der Name des physischen Formats der ankommenden Nachricht.
ID des codierten Nachrichtenzeichensatzes Ja Nein Systemstandardwert des Brokers Die ID des codierten Zeichensatzes, anhand dessen die Bytes der gerade gelesenen Datei interpretiert werden.
Nachrichtverschlüsselung Ja Nein Systemstandardwert des Brokers Das Codeumsetzungsschema für Zahlen und umfangreiche Zeichen, anhand dessen die Bytes der gerade gelesenen Datei interpretiert werden. Gültige Werte sind Ermitteltes Brokersystem oder ein numerischer Codierungswert. Weitere Informationen zur Codierung finden Sie unter Daten mit Nachrichtenflüssen konvertieren.

In der folgenden Tabelle werden die Eigenschaften für die Parseroptionen des FileInput-Knotens beschrieben.

Eigenschaft M C Standardwert Beschreibung
Zeitpunkt für Syntaxanalyse Nein Nein Bei Bedarf Durch diese Eigenschaft wird gesteuert, zu welchem Zeitpunkt eine Eingabenachricht syntaktisch analysiert wird. Gültige Werte sind:
  • Bei Bedarf
  • Sofort
  • Vollständig

Eine vollständige Beschreibung dieser Eigenschaft finden Sie unter Bedarfsgerechte Syntaxanalyse.

Baumstruktur unter Verwendung von XML-Schemadatentypen erstellen Nein Nein Nicht ausgewählt Durch diese Eigenschaft wird gesteuert, ob die Syntaxelemente in der Nachrichtenbaumstruktur Datentypen aus dem XML-Schema enthalten.
XMLNSC-Kompaktparser für XMLNS-Domäne verwenden Nein Nein Nicht ausgewählt Durch diese Eigenschaft wird gesteuert, ob der XMLNSC-Kompaktparser für Nachrichten in der XMLNS-Domäne verwendet wird. Wenn Sie diese Eigenschaft festlegen, werden die Nachrichtendaten in Knoten, die mit dem Ausgabeterminal verbunden sind, unter XMLNSC angezeigt, wenn XMLNS die Nachrichtendomäne des MQRFH2-Eingabeheaders oder der Eigenschaft 'Syntaxanalyse der Eingabenachricht' ist.
Zugriff auf gemischten Inhalt Nein Nein Nicht ausgewählt Mit dieser Eigenschaft können Sie steuern, ob der XMLNSC-Parser Elemente in der Nachrichtenbaumstruktur erstellt, wenn er gemischten Text in einer Eingabenachricht feststellt. Wenn Sie das Kontrollkästchen aktivieren, werden Elemente für gemischten Text erstellt. Andernfalls wird gemischter Text ignoriert, und es werden keine Elemente erstellt.
Kommentare beibehalten Nein Nein Nicht ausgewählt Mit dieser Eigenschaft können Sie steuern, ob der XMLNSC-Parser Elemente in der Nachrichtenbaumstruktur erstellt, wenn er Kommentare in einer Eingabenachricht feststellt. Wenn Sie das Kontrollkästchen aktivieren, werden Elemente für Kommentare erstellt. Andernfalls werden Kommentare ignoriert, und es werden keine Elemente erstellt.
Verarbeitungsanweisung beibehalten Nein Nein Nicht ausgewählt Mit dieser Eigenschaft können Sie steuern, ob der XMLNSC-Parser Elemente in der Nachrichtenbaumstruktur erstellt, wenn er Verarbeitungsanweisungen in einer Eingabenachricht feststellt. Wenn Sie das Kontrollkästchen aktivieren, werden Elemente für Verarbeitungsanweisungen erstellt. Andernfalls werden Verarbeitungsanweisungen ignoriert, und es werden keine Elemente erstellt.
Nicht transparente Elemente Nein Nein   Über diese Eigenschaft wird eine Liste von Elementen in der Eingabenachricht angegeben, die vom XMLNSC-Parser nicht transparent analysiert werden sollen.

In der folgenden Tabelle werden die Abfrageeigenschaften des FileInput-Knotens beschrieben:

Eigenschaft M C Standardwert Beschreibung
Abfrageintervall (Sekunden) Ja Ja 5 Das Abfrageintervall in Sekunden.

In der folgenden Tabelle werden die Wiederholungseigenschaften des FileInput-Knotens beschrieben:

Eigenschaft M C Standardwert Beschreibung
Wiederholungsmechanismus Ja Nein Fehler Handhabung eines Flussfehlers durch den Knoten Folgende Optionen sind gültig:
  • Fehler
  • Kurze Wiederholungszeit
  • Kurze und lange Wiederholungszeit
Wiederholungsschwellenwert Ja Ja 0 Mit diesem Wert wird angegeben, wie oft die Flusstransaktion wiederholt werden soll, wenn für Wiederholung Kurze Wiederholungszeit angegeben ist.
Kurzes Wiederholungsintervall Nein Ja 0 Das Intervall in Sekunden zwischen den Wiederholungen, wenn für den Wiederholungsschwellenwert ein Wert ungleich null angegeben ist.
Langes Wiederholungsintervall Nein Ja 300 Das Intervall zwischen den einzelnen Wiederholungen, wenn für den Wiederholungsmechanismus die Option Kurze und lange Wiederholungszeit angegeben ist und der Wiederholungsschwellenwert erreicht ist.
Maßnahme bei fehlgeschlagener Datei Ja Ja In Unterverzeichnis für die Zurücksetzung verschieben Die Maßname, die der Knoten für die Eingabedatei ergreift, wenn alle Versuche, den Dateiinhalt zu verarbeiten, fehlgeschlagen sind. Folgende Optionen sind gültig:
  • In Unterverzeichnis für die Zurücksetzung verschieben
  • Löschen
  • Zeitmarke hinzufügen und in Unterverzeichnis für Zurücksetzung verschieben

In der folgenden Tabelle werden die Eigenschaften 'Datensätze und Elemente' des FileInput-Knotens beschrieben:

Eigenschaft M C Standardwert Beschreibung
Datensatzerkennung Ja Nein Gesamte Datei Mechanismus zur Identifikation von Datensätzen in der Eingabedatei. Folgende Optionen sind gültig:
  • Gesamte Datei
  • Feste Länge
  • Mit Begrenzer
  • Syntaktisch analysierte Folge
Länge Ja Nein 80 Die Länge der einzelnen Datensätze in Bytes, wenn die Datensatzerkennung Feste Länge ausgewählt ist.
Begrenzer Ja Nein DOS- oder UNIX-Linienende Die Art der Begrenzerbytes, mit denen die einzelnen Datensätze getrennt oder beendet werden, wenn die Datensatzerkennung Mit Begrenzer ausgewählt ist. Folgende Optionen sind gültig:
  • DOS- oder UNIX-Linienende
  • Angepasster Begrenzer
Angepasster Begrenzer Nein Nein   Die hexadezimal ausgedrückten Begrenzerbytes, wenn die Datensatzerkennung Mit Begrenzer und Angepasster Begrenzer ausgewählt sind. Falls für die Eigenschaft Begrenzer nicht Angepasster Begrenzer festgelegt ist, ist diese Eigenschaft nicht obligatorisch.
Begrenzertyp Ja Nein Postfix Position des Begrenzers, wenn die Datensatzerkennung Mit Begrenzer und Angepasster Begrenzer ausgewählt sind. Folgende Optionen sind gültig:
  • Postfix
  • Infix
Diese Eigenschaft wird ignoriert, es sei denn, Begrenzer ist auf Angepasster Begrenzer gesetzt.

In der folgenden Tabelle werden die Validierungseigenschaften des FileInput-Knotens beschrieben.

Eine umfassende Beschreibung dieser Eigenschaften finden Sie unter Auswertungseigenschaften.

Eigenschaft M C Standardwert Beschreibung
Auswertung Nein Ja Keine Durch diese Eigenschaft wird gesteuert, ob eine Auswertung stattfindet. Gültige Werte sind:
  • Keines
  • Inhalt und Wert
  • Inhalt
Aktion bei Fehler Nein Nein Ausnahme Durch diese Eigenschaft wird gesteuert, was beim Fehlschlagen der Auswertung geschieht. Gültige Werte sind:
  • Benutzertrace
  • Lokales Fehlerprotokoll
  • Ausnahme
  • Ausnahmelistet

In der folgenden Tabelle werden die FTP-Eigenschaften des FileInput-Knotens beschrieben:

Eigenschaft M C Standardwert Beschreibung
FTP Nein Ja Nicht ausgewählt Diese Eigenschaft bestimmt, ob der Knoten die auf der Registerkarte FTP aufgeführten FTP-Eigenschaften verwendet und Dateien von einem FTP-Server liest.
FTP-Server und -Port Nein Ja None (Keinen) Die IP-Adresse oder der Name (und wahlweise auch die Portnummer) eines fernen FTP-Servers (z. B. ftp.server.com:21) oder der Name eines konfigurierbaren Service vom Typ 'FtpServer'. Bei Angabe des Namens eines konfigurierbaren Service können die folgenden FTP-Eigenschaften komplett oder teilweise von dem konfigurierbaren Service überschrieben werden.
Sicherheitsidentität Nein Ja   Der Name der Benutzeridentifikation für den Zugriff auf den FTP-Server. Diese Eigenschaft wird mit der Eigenschaft 'securityIdentity' im konfigurierbaren FTP-Server-Service überschrieben, falls definiert.
Serververzeichnis Nein Ja "." Das Verzeichnis auf dem FTP-Server, aus dem Dateien übertragen werden sollen. Wird hierfür ein relativer Pfad angegeben, bezieht sich dieser auf das Ausgangsverzeichnis nach der Anmeldung. Diese Eigenschaft wird mit der Eigenschaft 'remoteDirectory' im konfigurierbaren FTP-Server-Service überschrieben, falls definiert.
Übertragungsmodus Nein Nein Binär Der FTP-Übertragungsmodus für die Übertragung von Dateidaten. Folgende Optionen sind gültig:
  • Binär
  • ASCII
Diese Eigenschaft wird mit der Eigenschaft 'transferMode' im konfigurierbaren FTP-Server-Service überschrieben, falls definiert.
Scan-Verzögerung Nein Ja 60 Die Verzögerung in Sekunden zwischen den Suchläufen für die fernen Verzeichnisse. Diese Eigenschaft überschreibt den Wert für Abfrageintervall, wenn das Kontrollkästchen 'FTP' markiert ist. Diese Eigenschaft wird mit der Eigenschaft 'scanDelay' im konfigurierbaren FTP-Server-Service überschrieben, falls definiert.

In der folgenden Tabelle werden die Transaktionseigenschaften des FileInput-Knotens beschrieben:

Eigenschaft M C Standardwert Beschreibung
Transaktionsmodus Nein Ja Ja Der Transaktionsmodus auf diesem Empfangsknoten ist entscheidend dafür, ob die übrigen Knoten in dem Fluss unter Verwendung eines Synchronisationspunkts ausgeführt werden. Folgende Optionen sind gültig:
  • Ja
  • Nein
In der folgenden Tabelle werden die Instanzeigenschaften des FileInput-Knotens beschrieben. Eine umfassende Beschreibung dieser Eigenschaften finden Sie unter Konfigurierbare Nachrichtenflusseigenschaften.
Eigenschaft M C Standardwert Beschreibung
Pool zusätzlicher Instanzen Nein Ja Pool verwenden, der dem Nachrichtenfluss zugeordnet ist Der Pool, aus dem zusätzliche Instanzen bereitgestellt werden sollen.
  • Bei Auswahl von Pool verwenden, der dem Nachrichtenfluss zugeordnet ist werden zusätzliche Instanzen aus dem Nachrichtenflusspool bereitgestellt.
  • Wenn Sie Pool verwenden, der dem Knoten zugeordnet ist auswählen, werden zusätzliche Instanzen des Knotens bereitgestellt, deren Anzahl auf dem Wert basiert, der für die Eigenschaft Zusätzliche Instanzen angegeben wurde.
Zusätzliche Instanzen Nein Ja 0 Die Anzahl der zusätzlichen Instanzen, die der Knoten starten kann, wenn für die Eigenschaft Pool zusätzlicher Instanzen Pool verwenden, der dem Knoten zugeordnet ist angegeben wurde.
Bemerkungen | Marken | Downloads | Bibliothek | Unterstützung | Rückmeldung
Copyright IBM Corporation 1999, 2007 Letzte Aktualisierung: Jan 24, 2008
ac55150_