Directives
RENAME Change a File's Name
   
Format RENAME old_name${, | TO } new_name$ [,OPT=options$ ] [ ,ERR=stmtref ]

Where:

new_name$ New name for the file. String expression.
old_name$ Name of an existing file to be renamed. String expression.
options$ Options to apply to the RENAME. Currently the only valid option is "ALLSEG" to rename all segments of a multi-segmented file.
stmtref Program line number or statement label to which to transfer control.
TO Keyword, not case-sensitive (a comma may substitute for TO).
   
Description Use the RENAME directive to change the name of an existing file. The first string must contain the current name of the file. (The file must already exist.) Use the second string expression for the new name of the file.

When the ‘OR' system parameter is set, the RENAME directive will assume that the new filename contains a fully expanded OS pathname to the same directory as the old filename. If the path is omitted from the existing file name, the standard ProvideX search rules will apply. If the path is omitted from the new name, the renamed file will be located in the local working directory.
* Note * The new filename must not duplicate an existing filename. You must have exclusive access to the file you are renaming. ProvideX is subject to OS rules for the renaming of files.

If an operating system stores files by inode number, it may permit the renaming of active files because it is the inode that is in use and not the name associated with it. Other operating systems require that files not be in use before they can be renamed. Some operating systems do not allow you to rename a file to a different directory.
Multi-segment files If you want to rename a file that may have multiple segments you need to either include an ,OPT="ALLSEG" or enable the '+E' system parameter. This will assure all segments are renamed to correspond to the primary file's new name.

Prior renaming the main file the system will verify that all segments can be renamed without conflict. If a file name conflict occurs for any segment an error will generated and no files will be renamed.

Renaming related segments is a +PxPlus Exclusive
   
Examples 0010 ERASE "ordlst"
0020 RENAME "ordcur","ordlst"
0030 KEYED "ordcur",6
 
RENAME "OLDFILE" TO "NEWFILE"