⎕FRENAME Rename component file

The ⎕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 returned by ⎕FNAMES.

Two alternative syntax forms are supported for ⎕FRENAME:

 NEWNAME ⎕FRENAME OLDNAME

or

 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 ⎕MOUNT), and the file extension .aqf is added automatically.

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.