Rename: Difference between revisions

From BR Wiki
Jump to navigation Jump to search
(Imported RENAME command page from old wiki)
 
(edit content)
Line 2: Line 2:


====Comments and Examples====
====Comments and Examples====
The following command renames the file TEST.1 to TESTPRO.1 and sends all messages that normally appear on the screen to the printer. Business Rules assumes that TEST.1 is in the default directory of the disk in drive B and that TESTPRO.1 is to remain in the same directory:
The following command renames the file TEST.1 to TESTPRO.1 and sends all messages that normally appear on the screen to the printer. BR assumes that TEST.1 is in the default directory of the disk in drive B and that TESTPRO.1 is to remain in the same directory:


  RENAME B:TEST.1 B:TESTPRO.1 PRINT
  RENAME B:TEST.1 B:TESTPRO.1 PRINT
Line 8: Line 8:
The next command moves the file ANDOVER from the default directory to the MICHIGAN directory:
The next command moves the file ANDOVER from the default directory to the MICHIGAN directory:


  RENAME C:ANDOVER C:\\MICHIGAN\\ANDOVER
  RENAME C:ANDOVER C:\MICHIGAN\ANDOVER


The following example moves all files in the current subdirectory of drive C to the \\STDNTS\\NAMES subdirectory on drive C. The original file name of each file is maintained:
The following example moves all files in the current subdirectory of drive C to the \STDNTS\NAMES subdirectory on drive C. The original file name of each file is maintained:


  RENAME C:*.* C:\\STDNTS\\NAMES\\*.*
  RENAME C:*.* C:\STDNTS\NAMES\*.*


====Syntax====
====Syntax====
Line 23: Line 23:
RENAME requires two parameters.
RENAME requires two parameters.


"Old file-ref" is the present name (and path, if required) of the file to be renamed.
'''Old file name''' is the present name (and path, if required) of the file to be renamed.


"New file-ref" is the new name (and path) of the file. Both parameters accept wildcard characters.
'''New file name''' is the new name (and path) of the file. Both parameters accept wildcard characters.


The optional ">file-ref" parameter saves the messages that normally appear on the screen during the renaming process to the file you specify in the file-ref.
The optional '''>file name''' parameter saves the messages that normally appear on the screen during the renaming process to the file you specify in the file name.


"PRINT" sends screen messages to a printer.
'''PRINT''' sends screen messages to a printer.


Three optional parameters, when separated from the rest of the command with a dash, can follow the RENAME command:
Three optional parameters, when separated from the rest of the command with a dash, can follow the RENAME command:
:"N" |prevents the screen from displaying a log of performed actions.
:'''N''' prevents the screen from displaying a log of performed actions.
:"P" |pause after the log of freed files fills one screen (press <CR> to see the next screen).
:'''P''' pause after the log of freed files fills one screen (press <CR> to see the next screen).
:"V" |requires the operator to Verify each renaming action before Business Rules performs it.
:'''V''' requires the operator to Verify each renaming action before BR performs it.
:"F" |force deletion of files when it is necessary in order to complete the rename process.
:'''F''' force deletion of files when it is necessary in order to complete the rename process.





Revision as of 11:56, 26 December 2011

The Rename (REN) command renames or moves one or more files.

Comments and Examples

The following command renames the file TEST.1 to TESTPRO.1 and sends all messages that normally appear on the screen to the printer. BR assumes that TEST.1 is in the default directory of the disk in drive B and that TESTPRO.1 is to remain in the same directory:

RENAME B:TEST.1 B:TESTPRO.1 PRINT

The next command moves the file ANDOVER from the default directory to the MICHIGAN directory:

RENAME C:ANDOVER C:\MICHIGAN\ANDOVER

The following example moves all files in the current subdirectory of drive C to the \STDNTS\NAMES subdirectory on drive C. The original file name of each file is maintained:

RENAME C:*.* C:\STDNTS\NAMES\*.*

Syntax

File:HELP0052.jpg

Default

Display a log of performed actions on the screen.

Parameters

RENAME requires two parameters.

Old file name is the present name (and path, if required) of the file to be renamed.

New file name is the new name (and path) of the file. Both parameters accept wildcard characters.

The optional >file name parameter saves the messages that normally appear on the screen during the renaming process to the file you specify in the file name.

PRINT sends screen messages to a printer.

Three optional parameters, when separated from the rest of the command with a dash, can follow the RENAME command:

N prevents the screen from displaying a log of performed actions.
P pause after the log of freed files fills one screen (press <CR> to see the next screen).
V requires the operator to Verify each renaming action before BR performs it.
F force deletion of files when it is necessary in order to complete the rename process.