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.


Note:


In order to maintain compatibility with IBM ISPF, SPFLite uses REN as an abbreviation for RENUM (RENUMBER) rather than RENAME. However, most SPFLite users are likely to use RENAME far more often than the mainframe-oriented RENUMBER command. If you use RENAME frequently, and would prefer to be able to use REN as an abbreviation for RENAME, you can issue the following SET command:


SET ALIAS.REN = RENAME


Or, you can issue a SET command with no arguments to bring up the SET EDIT screen, and enter a line like this:


ALIAS.REN=RENAME

 


Created with the Personal Edition of HelpNDoc: Free iPhone documentation generator