For a particular database on the user's workspace, RenameDatabase locates a replica of that database (based on its replica ID) on the specified server, and replaces the database icon with that of the replica. The only change the user sees is that the server name has changed on the database icon.

Syntax

@Command( [RenameDatabase] ; server : database ; newServer )

Parameters

server

Text. The name of the server where the database is.

Text. The path and file name of the database. Specify the database's name and location using the appropriate format for the operating system.

Text. The name of the server where a replica of the database is.

You can only use this for replicas of a database, not copies. You cannot use this command to change the name of a server.

If the workspace has stacked replica icons for the database on both server and newServer, RenameDatabase brings the icon for newServer to the front.

This command does not work on the Web.

Language cross-reference

OpenByReplicaID method of LotusScript NotesDatabase class

Example
See Also

@Commands

Glossary