@XWRITE - Inhalt der aktuellen Arbeitsdatei in eine POSIX- Datei speichern

Mit der Anweisung @XWRITE kann der Inhalt der aktuellen Arbeitsdatei in eine POSIX-Datei geschrieben werden. Die Arbeitsdatei bleibt dabei erhalten. Diese Anweisung wird nur noch aus Kompatibilitätsgründen unterstützt. Es wird empfohlen, stattdessen die Anweisung @WRITE (Format 1) mit dem Operanden POSIX-FILE zu benutzen.

Operation	Operanden	F-Modus, L-Modus
@XWRITE	FILE=xpath [,CODE= { name | EBCDIC | ISO } ] [,MODE={ ANY | UPDATE | NEW | REPLACE } ]

xpath	Pfadname der POSIX-Datei, die geschrieben werden soll Der Operand xpath kann auch als Zeichenfolgevariable angegeben werden. Er muss als Zeichenfolgevariable angegeben werden, wenn der Pfadname Zeichen enthält, die in der EDT-Syntax eine Sonderbedeutung haben (z.B. Leerzeichen, Semikolon im F-Modus oder Komma). Wird xpath nicht angegeben, wird eine mit @XOPEN oder @OPEN (Format 1) geöffnete POSIX-Datei zurück geschrieben. Gibt es keine geöffnete POSIX-Datei, wird die Anweisung mit der Meldung EDT5122 abgewiesen. Ist die angegebene Datei nicht wie erforderlich zugreifbar, wird die Anweisung mit einer entsprechenden Fehlermeldung abgewiesen.
CODE=	Es wird festgelegt, in welchem Zeichensatz die POSIX-Datei geschrieben wird. Wird CODE nicht angegeben, wird die Datei in dem mit @PAR CODE eingestellten Zeichensatz geschrieben (auch beim Zurückschreiben von Dateien, die mit einem anderen Zeichensatz geöffnet wurden). Nach dem Starten des EDT ist EDF041 eingestellt.
name	Zeichensatz der zu schreibenden POSIX-Datei. Als name muss der Name eines gültigen Zeichensatzes angegeben werden (siehe Abschnitt „Zeichensätze“).
EBCDIC	Das Schlüsselwort EBCDIC wird nur noch aus Kompatibilitätsgründen als Synonym für den Zeichensatz EDF041 unterstützt.
ISO	Das Schlüsselwort ISO wird nur noch aus Kompatibilitätsgründen als Synonym für den Zeichensatz ISO88591 unterstützt.
MODE=	Legt fest, ob die Datei schon vorhanden sein soll bzw. sein darf. Beim Zurückschreiben geöffneter Dateien wird der Operand ignoriert.
ANY	Falls die Datei schon existiert, wird sie überschrieben, andernfalls wird sie neu angelegt und geschrieben. Dies ist der Standardwert.
UPDATE	Die Datei, die geschrieben werden soll, muss bereits existieren, andernfalls wird die Meldung EDT5310 ausgegeben.
NEW	Die Datei wird neu angelegt und geschrieben. Sie darf noch nicht vorhanden sein, andernfalls wird die Meldung EDT5311 ausgegeben.
REPLACE	Hat die gleiche Bedeutung wie ANY. Falls die Datei schon existiert, wird sie überschrieben, andernfalls wird sie neu angelegt und geschrieben.

Wurde eine POSIX-Datei mit @XOPEN oder @OPEN (Format 1) geöffnet, so kann die Angabe des Dateinamens bei @XWRITE entfallen. Der Inhalt der geöffneten Datei wird durch den Inhalt der Arbeitsdatei ersetzt. Die Datei bleibt geöffnet, bis @CLOSE abgesetzt wird.

Wird die Arbeitsdatei vor dem Schreiben umcodiert und enthält sie Zeichen, die im Zeichensatz der zu schreibenden Datei ungültig sind, werden diese durch ein Ersatzzeichen ersetzt, sofern ein solches spezifiziert ist (siehe @PAR SUBSTITUTION-CHARACTER), andernfalls wird die Datei nicht geschrieben und die Fehlermeldung EDT5453 ausgegeben. Der Benutzer kann dann ein Ersatzzeichen definieren oder den Zeichensatz für das Schreiben verändern und @XWRITE erneut ausführen.

Wird die Anweisung mit [K2] unterbrochen und der EDT-Lauf mit /INFORM-PROGRAM fortgesetzt, so wird die Bearbeitung der Anweisung abgebrochen und die Meldung EDT5501 ausgegeben.

Achtung

Da MODE=ANY voreingestellt ist, werden bei fehlender MODE-Angabe bereits existierende Dateien ohne Warnung überschrieben.