RENAME-FILE

The jBASE RENAME-FILE command allows the user to rename a file and it's dictionary with a single command.

COMMAND SYNTAX

RENAME-FILE filename

SYNTAX ELEMENTS

filename is the name the file to be renamed. The file type must be one of the supported jBASE file types.

NOTES

RENAME-FILE doesn't require a '(' when specifying the destination file name.  The destination file name must not exist or the rename will fail. 

RENAME-FILE assumes that the dictionary section of the specified file exists. The command will fail if it cannot open the dictionary section. It will rename the data section and the dictionary section. If you only want to move the data or dictionary portion of a file, use jmv.

RENAME-FILE calls an internal function to perform the rename. If transaction journaling is active, the rename is logged as a MOVEFILE transaction.

RENAME-FILE does not work on files that contain operating system meta-characters (e.g. "SALES*MAR").

EXAMPLES

RENAME-FILE File1

Renamed file .\File1 to .\New.File1
Renamed file .\File1]D to .\New.File1]D

Renames the file File1 and it's dictionary to New.File1.

Files