3.16 adddatabase

Adds a database.

Parameters:

$kiriwrite_dbmodule->adddatabase(options);

Usage:

$kiriwrite_dbmodule->adddatabase({ DatabaseFilename => "database", DatabaseName => "Database Name", DatabaseDescription => "Database Description", DatabaseNotes => "Some notes about the database", DatabaseCategories => "database, new, categories", VersionMajor => 0, VersionMinor => 4, VersionRevision => 0 });

options
Specifies the following options as a hash in any order.

Value Description
DatabaseFilename Specifies the filename of the new database.
DatabaseName Specifies the name of the new database.
DatabaseDescription Specifies the description of the new database.
DatabaseNotes Specifies the notes of the new database.
DatabaseCategories Specifies the categories of the new database.
VersionMajor Specifies the major version number of the new database.
VersionMinor Specifies the minor version number of the new database.
VersionRevision Specifies the revision version number of the new database.

If a database is created but the filename already exists (after checking if it does exist using the dbexists subroutine) then the error returned should be 'DatabaseExists' in the $error scalar.

If a database error occurs while adding the database, the error returned should be 'DatabaseError' in the $error scalar and the information about the error placed in the $errorext scalar.