Creates an empty copy of the current database.

Defined in

NotesDatabase

Syntax

Set notesDatabaseNew = notesDatabase.CreateCopy( newServer$, newDbFile$ [, maxsize% ] )

Parameters

newServer$

String. The name of the server where the new database resides. Use an empty string ("") to create a copy on the current computer.

String. The file name of the new copy.

Note This parameter is new with Release 5.

Integer. Optional. The maximum size (in gigabytes) that you would like to assign to the new database. This parameter applies only to Release 4 databases or those created on a server that has not been upgraded to Release 5. Entering an integer greater than 4, generates a run-time error that reads "Maximum size for database is 4 (gigabytes)," and the script fails.

notesDatabaseNew

NotesDatabase. The new copy.

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

The copy contains the design elements of the current database, an identical access control list, and an identical title. It does not contain any documents.

The copy is not a replica.

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.

The ACL of the original database gets copied to the new database, but you may want to modify the copy ACL. For example, you may want Manager access to the copy for yourself even if you're not a manager of the original. Use the methods GrantAccess and RevokeAccess to modify the copy's ACL.

If the database property "Database is a template" is checked, the source is treated as a template instead of a database, and the method acts like the CreateFromTemplate method.

Language cross-reference

createCopy method in Java Database class

@Command([FileDatabaseCopy]) function in formula language

Example
See Also

Creating and deleting a database