Creates a replica of the current database at a new location.

Defined in

NotesDatabase

Syntax

Set notesDatabaseReplica = notesDatabase.CreateReplica( newServer$, newDbFile$ )

Parameters

newServer$

String. The name of the server where the replica will reside. Use an empty string ("") to create a replica on the current computer.

String. The file name of the replica.

notesDatabaseReplica

NotesDatabase. The new replica.

If a database with the specified file name already exists on the newServer$, an error is raised.

The new replica has the same access control list as the current database.

Scripts running on a server can't create or access databases on other servers. Therefore, if the script runs on a server, the newServer$ parameter must correspond to the server where the script is running. There are two ways that this can happen:

• Use an empty string ("") to indicate the current computer. This is the safer method.
• Make sure the name of the server where the script runs matches the name of the newServer$ parameter.

Language cross-reference

createReplica method in Java Database class

@Command([FileNewReplica]) function in formula language

Example
See Also

Creating and deleting a database