Entering content frame

 Creating a Database Instance 

Use

You create a new database instance on a local or remote server. All kernel variant (fast and slow) are always created for this.

Prerequisites

You have the authorizations of an operating system user for the server on which the database instance is to be created.

To create a database instance on a remote server under Microsoft Windows, you must also have administrator authorizations for the database server and the authorization log on as batch job. For information about maintaining operating system users, see your operating system documentation.

If several versions of the database software are available on the database server, you must specify the path of the version to which this database instance is to be assigned when registering the database instance. To do this, use the option -R (installation directory of the database software) when calling the Database Manager CLI.

Syntax

db_create [-a|-auto] <database_name> <dbm_user>,<dbm_user_password> [<os_user>,< os_user_password>]

-a | -auto

If you use this option, under Microsoft Windows NT the service entry Start-up-type in the Control Panel is set to automatic.

Under the UNIX operating system this parameter is ignored.

database_name

Name of database instance, maximum length eight characters

dbm_user

Database Manager Operators (DBM Operators)

This operator is stored on the database server when you start to create the database. Subsequent access to the database instance is possible only with this operator.

dbm_user_password

The DBM operator’s password

os_user

Operating system user

If you want to create the database instance on a remote server, you must also specify the operating system user for this server. If the logon to the operating system fails, the database instance cannot be installed.

os_user_password

The operating system user’s password

From now on, to access the new database instance, you need the data specified in <dbm_user> and<password>.

Example

In Microsoft Windows:

Log on to the Database Manager CLI, create a local database instance called HOTELDB, define the DBM operator DAVID with password BLUE:
dbmcli db_create HOTELDB DAVID,BLUE

Log on to the Database Manager CLI, create a local database instance called HOTELDB with the software stored under C:\Program Files\SDB\V75, define the DBM operator DAVID with password BLUE:

dbmcli -R "C:\Program Files\SDB\V75" db_create HOTELDB DAVID,BLUE

Log on to the Database Manager CLI, create a database instance called HOTELDB on the remote server GENUA, define the DBM operator DAVID with password BLUE, log on to the remote server as operating system user ANNA with password BLACK:
dbmcli –n GENUA db_create HOTELDB DAVID,BLUE ANNA,BLACK

In UNIX:

Log on to the Database Manager CLI, create a local database instance called HOTELDB, define the DBM operator DAVID with password BLUE, use option –s to avoid being identified as the operating system user

dbmcli -s db_create HOTELDB DAVID,BLUE

Reply

There is an OK message after the command has been executed successfully.

In the event of errors, see Reply Format.

 

Example: How to Create a Database Instance

Example: How to Create an Archive Type Database Instance

 

Leaving content frame