FILERENAME

Applies to	AppCtrlScript (Module: wmACScr1.dll)
Group	File
See also	FILEMOVE,FILECOPY, FILEDELETE, CNV2LEGALFILENAME, SETFILEREADONLY

Renames a file in a directory. Works also with UNC filenames but not with FTP sites. Unlike FILEMOVE command the destination folder must be in the same as source. So this is a rename within the same folder only.

Source filename must be a full name (not a folder or filename only) but destination can be a filename only, so path in destination can be omitted.

If the source file does not exist or the file cannot be renamed (for example if the destination file already exists), error 5024 will occur. In addition to that before an error will occur with different number telling in more detail why rename failed. If source and destination path is not the same then an error 5025 will occur.

You may have to make sure that the destination filename contains only valid characters. You can use the CNV2LEGALFILENAME command to eliminate illegal characters in the filename.

Syntax

FILERENAME <SourceFileName>, <DestinationFileName>
RENAMEFILE <SourceFileName>, <DestinationFileName>

Part	Description
<SourceFileName>	Complete filename of the file to be renamed.
<DestinationFileName>	Destination filename.