Description:
Renames a file(s). The file argument may include placeholders and wildcards.
Additionally, the scope for name clash resolution is determined by path in the
file argument. If no path is argued then the new name must not clash with
any spot in the unit. If path is argued, the new name must not clash with any
spot within that path. The new name may include placeholders and wildcards,
and enclosing quotes are optional.
Form:
RENAME|REN|RN [FILENAME] [NEW_NAME]
Argument List:
Argument Description
FILENAME Name, may include placeholders or wildcards.
NEW_NAME New file name, placeholders and wildcards valid, quotes optional.
Response:
MODIFY RENAME RESPONSE
Verbose- "ERROR- [Description]\r\n" if any fatal error preventing operation, or
"OK\r\n" to acknowledge receipt of command, followed by
"Renamed FILENAME to NEW_NAME\r\n" for every file renamed, followed by
"OK\r\n" to confirm every file operation or
"ERROR- [Description]\r\n" to report file operation error, concluding with
"Renamed NNNN file(s)\r\n" after all file operations complete
Terse- "[NON-ZERO NUMERIC VALUE]\r\n" if any fatal error preventing operation, or
"0\r\n" to acknowledge receipt of command, followed by
"FILENAME NEW_NAME\r\n" for every file renamed, followed by
"0\r\n" to confirm every file operation or
"[NON-ZERO NUMERIC VALUE]\r\n" to report file operation error
"\r\n" concludes modify responses (empty line)
Examples:
Verbose command to rename a file:
RENAME VAC2.MPG VAC3.MPG <enter>
Response is: OK\r\n
Renamed VAC2.MPG to VAC3.MPG\r\n
OK\r\n
Terse command to rename a file:
RN 0 0 1 VAC2.MPG <enter>
Response is: 0\r\n
VAC2.MPG VAC3.MPG\r\n
0\r\n
Notes:
The scope for name clash resolution is determined by the path argument. If no
path is given then the new name must not clash with any spot in the unit. If path
is argued, the new name must not clash with any spot within that path. The new name
may include placeholders and wildcards, and enclosing quotes are optional. ".MPG"
extension must follow NAME.
Products Supporting Command