LocalEnvironment-Variablen mit Dateiknoten verwenden

In diesem Abschnitt werden die für die Verarbeitung von Dateien mittels Dateiknoten verfügbaren LocalEnvironment-Variablen beschrieben.

Zur dynamischen Abfrage und Änderung der Dateiknoteneigenschaften können Sie verschiedene Felder der 'LocalEnvironment' verwenden. Diese Felder befinden sich in den folgenden Nachrichtenbaumstrukturen:

LocalEnvironment.File-Felder

Wenn Sie den FileInput-Knoten verwenden, speichert er Informationen, die Sie in der Nachrichtenbaumstruktur 'LocalEnvironment.File' abrufen können. Die Felder dieser Struktur werden in folgender Tabelle beschrieben:
Tabelle 1.
Elementname Elementdatentyp Beispiel
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 Ganzzahl 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 Ganzzahl 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.
Diese Struktur wird mit jeder Nachricht, die an das Ausgabeterminal des FileInput-Knotens gesendet wird, und mit jeder leeren Nachricht, die an das Datenendterminal gesendet wird, weitergeleitet.

LocalEnvironment.WrittenDestination.File-Felder

Wenn Sie den FileOutput-Knoten verwenden, speichert er Informationen, die Sie in der Nachrichtenbaumstruktur 'LocalEnvironment.WrittenDestination.File' abrufen können. Die Felder dieser Struktur werden in folgender Tabelle beschrieben:
Tabelle 2.
Elementname Elementdatentyp Beispiel
Directory CHARACTER Absoluter Verzeichnispfad des Ausgabeverzeichnisses 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 der Ausgabedatei.
Action CHARACTER Mögliche Werte:
  • Replace (Ersetzen), wenn eine Ausgabedatei mit dem gleichen Namen ersetzt wird.
  • Create (Erstellen), wenn eine neue Ausgabedatei erstellt wird.
  • Append (Anhängen), wenn die Nachricht einem Datensatz zugeordnet ist, der an eine Ausgabedatei angehängt ist.
  • Finish (Ende), wenn eine Dateibeendigungsnachricht eingeht und keine Datei vorliegt, die beendet werden kann (wenn z. B. Datensatz 'Gesamte Datei' angegeben ist und eine Nachricht an das Dateibeendigungsterminal gesendet wird).
  • Transmit (Übertragen), wenn die Datei mittels FTP übertragen und danach gelöscht wurde.
Zeitmarke CHARACTER Der Zeitpunkt (Datum und Uhrzeit) in Form einer Zeichenfolge, zu dem der Knoten die Verarbeitung dieser Datei gestartet hat. Dieser Wert wird den Dateinamen der archivierten Dateien als Präfix vorangestellt, wenn auf der Registerkarte Grundeinstellung unter Maßnahme für Ausgabedatei die Option Zeitmarke, bestehende Datei archivieren und ersetzen angegeben ist.

LocalEnvironment.Wildcard.WildcardMatch-Feld

Für den FileInput-Knoten können Sie ein Dateinamensmuster mit Platzhalterzeichen festlegen. Der FileInput-Knoten kopiert die Zeichen des Dateinamens, die den Platzhalterzeichen entsprechen, sowie alle dazwischen liegenden Zeichen in das Feld 'LocalEnvironment.Wildcard.WildcardMatch'.
Tabelle 3.
Elementname Elementdatentyp Beispiel
WildcardMatch CHARACTER Die Zeichenfolge im Dateinamen, die den Platzhalterzeichen im Dateinamensmuster entspricht.
Beispiel: Wenn das für den FileInput-Knoten festgelegte Dateinamensmuster datei*.txt lautet und der Dateiname der gelesenen Datei datei02.txt, dann ist der Wert von WildcardMatch '02'. Lautet das Dateinamensmuster des FileInput-Knotens hingegen datei??typ.* und der Dateiname der gelesenen Datei datei02typ.xml, dann erhält WildCardMatch den Wert '02typ.xml'.

Für den FileOutput-Knoten können Sie ein Dateinamensmuster mit einem Platzhalter für ein einzelnes Zeichen festlegen. Wenn Sie dieses Zeichen, den Stern ('*'), im Dateinamensmuster einfügen, setzt der Knoten an Stelle dieses Zeichens den im Feld 'LocalEnvironment.Wildcard.WildcardMatch' gespeicherten Wert ein. Diese Konstellation empfiehlt sich bei Nachrichtenflüssen, in denen der FileInput-Knoten und der FileOutput-Knoten die gleiche Datei verarbeiten. Auf diese Weise erhalten Sie auch im FileOutput-Knoten den Namen der Eingabedatei. Der Wert des Elements 'WildcardMatch' kann auch mit Standardmethoden beliebig geändert werden. Sie benötigen dazu keinen FileInput-Knoten.

Zugehörige Konzepte
Baumstruktur für lokale Umgebung
Verarbeitung von Dateien durch den Broker
Zugehörige Tasks
Zugriff auf die Baumstruktur für die lokale Umgebung
Zugehörige Verweise
FileInput-Knoten
FileOutput-Knoten
Bemerkungen | Marken | Downloads | Bibliothek | Unterstützung | Rückmeldung
Copyright IBM Corporation 1999, 2007 Letzte Aktualisierung: Jan 24, 2008
ac55410_