⎕NRENAME Change the name of a native file

The ⎕NRENAME function allows you to rename a file in the host file system. 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 ⎕NNAMES.

Two alternative syntax forms are supported for ⎕NRENAME :

          'NEWNAME' ⎕NRENAME 'OLDNAME'
or
          'NEWNAME' ⎕NRENAME TIENO

'OLDNAME' is a character vector specifying the file to rename. The name may be either a full host path name, or the path may be omitted in which case the file to be renamed must be located in the current working directory.

'NEWNAME' is a character vector specifying the new name of the file.

TIENO: 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.

Special considerations for Client-Server implementations of APLX

See ⎕NCREATE for the conventions applying to file locations in Client-Server versions of APLX.