Dieses Kommando öffnet eine Textdatei zum Schreiben. Das Kommando fügt einen Block ein, in dem mit dem Kommando "Daten schreiben in Datei" Zeilen in die Datei ausgegeben werden können. Am Blockende wird die Datei geschlossen.
Wenn eine Datei kopiert werden sollen, muss außen ein Datei-Schreiben-Block stehen, und innerhalb dieses Blocks können mit Datei lesen die Zeilen gelesen und mit Daten schreiben in Datei wieder ausgegeben werden. Existiert die angegebene Datei bereits, wird sie überschrieben.
Beschränkung der Dateizugriffe: Wenn kein absoluter Pfad angegeben wird, wird der erste Ordner benutzt, der in der DLESessionConfig hinterlegt ist. Es können nur Dateien angesprochen werden, welche in einem der dort angegebenen Verzeichnisse liegen. Wenn dort nichts konfiguriert wurde, wird von der DLE keine Prüfung durchgeführt. Relative Pfade mit „..“ sind nicht zulässig.
Spezielle Felder: Im Basis-Paket sind einige spezielle Felder vordefiniert, mit denen Sonderzeichen explizit geschrieben werden können. Die Felder CR, NL, CRNL und TAB enthalten die entsprechenden Sonderzeichen.
Parameter:
- Dateiname: Name der Datei inklusive Verzeichnis mit / als Trennzeichen
- Characterset: Der Zeichensatz, mit dem die Datei geschrieben werden soll. Default ist der Systemzeichensatz. Damit ist eine Zeichensatzkonvertierung in Kombination mit dem Datei lesen Kommando möglich.
- Daten anhängen: Default = Nein. Bei Ja werden die zu schreibenden Daten an den Inhalt der Datei angehängt, bei Nein wird die Datei überschrieben.