Previous Next Chapter

RENAME command

Purpose:

This command is for renaming files, drawers and volumes.

Format:

RENAME [OLDNAME] <Name of file/drawer/volume to rename> [NEWNAME] <New name of the file/drawer/volume>

Template:

RENAME OLDNAME/A,NEWNAME/A

Parameters:

OLDNAME

Name of the file/drawer/volume to be renamed. This must be an absolute path, such as in RAM:Empty". A relative path, such as /fred/barney", will not work.

NEWNAME

The new name to assign to the file/drawer/volume. This must not be an absolute or relative path. For example, wilma" is valid new name, /wilma" or wilma:" would be invalid names.

Errors:

10 - If the object cannot be renamed.

Result:

-

Notes:

The RENAME command does not work like for example the AmigaDOS Rename" command. For example, RENAME ,ram:empty` ,newname`" will rename the file ,RAM:empty` to ,RAM:newname`.

Example:

/* Rename a drawer by the name of Old" in the RAM disk to New". */
ADDRESS workbench

RENAME ,RAM:Old` ,New`

Top Previous Next Chapter