Advertising banner:
RENAME  
Help Contents • Administration • FirstClass Scripting • Help Document
   
   
   
RENAME



Function
Renames an unprotected object. Separate the components of the path with colons. The PATHCHAR command can be used to change the default path character.



Syntax
RENAME targetpath objname
Parameters


targetpath
The path relative to the administrator’s Desktop.
DESKTOP userID targetpath
The path relative to the user's Desktop. Separate the components of the path with colons.
The PATHCHAR command can be used to change the default path character.
objname
The new name of the object.




Examples
To rename a conference from Employee Lounge to Staff Lounge, enter:
RENAME "General Conferences:employee lounge" "Staff Lounge"
To rename a conference on sbram’s Desktop from Presentations to Obsolete Presentations, enter:
RENAME DESKTOP sbram "Presentations" "Obsolete Presentations"
If the Presentations conference is protected, you will need to unprotect it first with the PUT PROPERTIES DESKTOP command.  
A leaf or container cannot be renamed if it is protected or read only. Rather than writing 3 commands to turn these attributes off, rename the object, then turn the attributes on again, you can rename an object with the PUT command and Properties keyword.
PUT PROPERTIES DESKTOP sbram "presentations" 1017 0 "Obsolete Presentations"
The "Protected" field on the Properties (Windows) or Get Info (Mac) form is 1016. Sending a command to unprotect an already unprotected command is preferable to having the RENAME command fail.