Difference between revisions of "RENAME"

From Recital Documentation Wiki
Jump to: navigation, search
 
 
(4 intermediate revisions by 2 users not shown)
Line 1: Line 1:
=RENAME=
 
 
 
==Class==
 
Disk and File Utilities
 
 
 
 
==Purpose==
 
==Purpose==
 
Change the name of a file
 
Change the name of a file
Line 11: Line 4:
  
 
==Syntax==
 
==Syntax==
RENAME <.dbf filename1> | (<expC>)[TO] <.dbf filename2> | (<expC>)
+
RENAME <.dbf filename1> | (<expC>) [TO] <.dbf filename2> | (<expC>)
  
  
Line 19: Line 12:
  
 
==Description==
 
==Description==
The RENAME command renames <filename1> to <filename2>.  Either filename can be substituted with an <expC>, enclosed in round brackets, which returns a valid filename.  If <filename2> already exists, the original file is overwritten.  If no file extension is present in the file name, then the Recital/4GL uses '.dbf'.  You cannot rename a file that is open.  You cannot rename a file onto another disk, the COPY FILE command can be used for this purpose.
+
The RENAME command renames <filename1> to <filename2>.  Either filename can be substituted with an <expC>, enclosed in round brackets, which returns a valid filename.  If <filename2> already exists, the original file is overwritten.  If no file extension is present in the file name, then Recital uses '.dbf'.  You cannot rename a file that is open.  You cannot rename a file onto another disk, the COPY FILE command can be used for this purpose.
  
  
Line 30: Line 23:
  
 
==Products==
 
==Products==
Recital Database Server, Recital Mirage Server, Recital Terminal Developer
+
Recital Server, Recital  
 
[[Category:Documentation]]
 
[[Category:Documentation]]
 
[[Category:Commands]]
 
[[Category:Commands]]
 +
[[Category:Disk and File Utilities]]
 +
[[Category:Disk and File Utilities Commands]]

Latest revision as of 11:29, 25 January 2010

Purpose

Change the name of a file


Syntax

RENAME <.dbf filename1> | (<expC>) [TO] <.dbf filename2> | (<expC>)


See Also

ALIAS, COPY FILE


Description

The RENAME command renames <filename1> to <filename2>. Either filename can be substituted with an <expC>, enclosed in round brackets, which returns a valid filename. If <filename2> already exists, the original file is overwritten. If no file extension is present in the file name, then Recital uses '.dbf'. You cannot rename a file that is open. You cannot rename a file onto another disk, the COPY FILE command can be used for this purpose.


Example

rename patrons.dbf to patron.dbf
rename events.ndx event.ndx


Products

Recital Server, Recital