# Umbenennen einer Datei (#FILE RENAME)

Der Befehl #FILE RENAME dient zum Umbenennen einer bereits vorhandenen Datei. Alle Parameter müssen zwingend angegeben werden. Das Weglassen eines Parameters führt zu einer entsprechenden Fehlermeldung.

Syntax:
#FILE RENAME [ PATHOLD="<Dateiname>" PATHNEW="<Dateiname>" OVRMODE=.. ]

PATHOLD= “<Dateiname>“ | Datei, die umbenannt werden soll, ggf. mit Verzeichnisangabe. Existiert dieses Verzeichnis bzw. die Datei nicht, wird das Programm mit einer Fehlermeldung abgebrochen.
PATHNEW= “<Dateiname>“ | (Ziel)Datei, in die umbenannt werden soll, ggf. mit Verzeichnisangabe. Wird hier ein anderes Verzeichnis als bei PATHOLD angegeben, wird die Datei mit dem neuen Namen in das Verzeichnis verschoben, sofern dieses existiert. Ist das Verzeichnis nicht vorhanden, wird eine entsprechende Fehlermeldung ausgegeben.
OVRMODE=.. | Bool’scher Wert, der angibt ob eine durch PATHNEW angegebene Datei überschrieben werden soll, wenn diese bereits vorhanden ist. 0: Datei darf nicht überschrieben werden. Ausgabe einer Fehlermeldung. 1: Bereits vorhandene Datei darf überschrieben werden.

Das Gleichheitszeichen (=) ist optional.

## Hinweis

Der Anwender muss in den Verzeichnissen PATHNEW und PATHOLD Schreibrechte haben, sonst führt das Umbenennen zu einem Fehler.

## Achtung

SCHREIBSCHUTZ:

Ein Fehler wird erzeugt, wenn die Datei, die umbenannt werden soll, schreibgeschützt ist oder die (Ziel)Datei bereits existiert und schreibgeschützt ist.

## Achtung

RELATIVE VERZEICHNISSE:

Ist bei PATHOLD nur der Dateiname angegeben, wird die Datei in den Ordnern der Hochlauf/Kanalparameterliste gesucht.

Gesucht wird in der Reihenfolge Hauptprogramm - Unterprogramm - Arbeitsverzeichnis.

Ist PATHNEW relativ angegeben, so wird das Verzeichnis von PATHOLD verwendet.

## Programmierbeispiel

Umbenennen einer Datei

%FileRename

N10 #FILE NAME[MSG="C:\Test.txt"] ;Datei anlegen

...

N40 #MSG SAVE["Write me into file"] ;Schreibt Text in die Datei

N60 #FILE RENAME[PATHOLD="C:\Test.txt" PATHNEW = "C:\NewName.txt" OVRMODE=1]

N70 M30