⎕FRENAME function allows you to rename a component
file. You must have the correct host access permission to rename the file. If
the file is currently tied, the name change will be reflected in the name list
Two alternative syntax forms are supported for
NEWNAME ⎕FRENAME OLDNAME
NEWNAME ⎕FRENAME TIENO
OLDNAME is a character vector specifying the
file to rename. The name is specified in the same way as for
⎕FCREATE. If the name contains a directory-separator character (: / or \),
it is treated as a full host path name (including the file extension, by
convention .aqf). Otherwise it is treated as basic file name
only, optionally preceded by a volume number 0 to 9, separated by one or more
spaces from the name. In the latter
case, the file is created in the directory 0 to 9 specified (the actual path is
set the preferences dialog or
and the file extension .aqf is added
NEWNAME is a character vector specifying the new
name of the file, specified in the same way.
The second syntax form is an alternative way to rename a
file which has already been tied.
TIENO is the tie number on which the file is tied.
Note that the host operating system may not allow you to
rename a file across different file systems or physical disks.