RENAME - Rename the Current Edit File

RENAME - Rename the Current Edit File

Syntax


RENAME

[ file-name ]


Operands


file-name


If you specify a simple (unqualified) file-name, then the file will be in the same directory as the file being edited after being renamed.  If you used a relative file-path (such as MYPATH\MYFILE.TXT) the file will be located relative to the directory where it is currently being edited.  If the file-name is a fully-qualified name, it will be located directly where you specify.  Note that if you rename a file to anything other than a simple name, the file will be removed from its current directory location and relocated to the new directory you specify.


If you do not specify a file name, a conventional Windows save dialog will be presented to allow you to select the new name the file is to be known as, and optionally the new directory where it is to be located.


Description


The RENAME primary command allows the currently-edited file to be renamed while being edited.  If the new name also introduces a previously unreferenced file extension, the Profile for the new extension will be created based on the old file's Profile.


When the command has no argument, RENAME will cause a Rename popup to be displayed, which asks for a new file name.  Once the file has been renamed, you may resume editing the file as usual.  You can Cancel the Rename popup if you change your mind and don't want to rename it.


RENAME may be issued from either an Edit session or a Browse session.


If you RENAME a browsed file, it does not change its content, but does change its name.  If you opened the file in Browse mode because another application was accessing (and possibly updating) this file, renaming it could interfere with the other application, and so this should be done with care.

Release note for SPFLite version 8.5


In SPFLite prior to release 8.5, the editor primary command REN was an abbreviation for the command RENAME.  As of SPFLite version 8.5, the editor primary command REN is now an abbreviation for the sequence numbering command RENUM.  This change was made for ISPF compatibility.


Because of this change, the RENAME command no longer has any abbreviations.  You must fully spell out the editor primary command name RENAME.



Created with the Personal Edition of HelpNDoc: Generate Kindle eBooks with ease