Entering content frame

Procedure documentation user_logon Locate the document in the library structure

Use

The specified Database Manager operator (DBM operator) logs on to the Database Manager program.

Before you log on to the Database Manager, you have to open a DBM server session. You can open this session before logging on to the Database Manager or at the same time as logging on.

A connection must always be made to the DBM server on the computer of the database instance to be administrated. If the database instance is located on a remote computer, you need to specify the name of the database computer too when logging on to the Database Manager.

Two Step Logon

You can first open the session with the DBM server and then log on to the Database Manager.

...

       1.      Opening a DBM Server session:

dbmcli – d <database_name> [-n <database_computer>]

       2.      Logging on to the Database Manager:

user_logon <dbm_user_name>,<dbm_user_password>

One Step Logon

You can perform both logon steps at the same time by using the DBM option –u | -U. In this case, the Database Manager executes the user_logon DBM command implicitly.

Note

Note the command has different meanings depending on whether it is upper or lower case.

Using the DBM Option -u

dbmcli -u [<dbm_user_name>,<dbm_user_password>] –d <database_name> [-n <database_computer>]

·         -u: explicit specification of the Database Manager operator identified by <dbm_user_name> and <dbm_user_password>

Example

Calling the database manager CLI as Database Manager operator OLEG with password MONDAY, logging on to the DEMODB database instance, displaying the operational state of the database instance:

dbmcli –u OLEG,MONDAY –d DEMODB db_state

Using the DBM Option –U (Logon with XUSER)

dbmcli -U [<user_key>] –d <database_name> [-n <database_computer>]

·         -U: logon with a user stored in the XUSER file

You can use the XUSER program to store sets of user data as user keys and use them when logging on. User keys for Database Manager operators can be used successfully only if the operators stored in them have actually been created for the database instance in question (see also: Creating Database Manager Operators).

If you do not specify a <user_key> when using –U, the Database Manager attempts to use the data under the DBMUSR user key. It is therefore recommended that you create an XUSER entry with the user key name DBMUSR and create the data for the Database Manager operator with the most comprehensive authorizations (see also: Creating or Changing XUSER Entries).

 

Reply

dbmcli on [<database_computer>]: <database_name>

In the event of errors, see Reply Format

Examples

Two Step Logon

Opening a DBM server session with the local database instance DEMODB and logging on as DBM operator OLEG with password MONDAY:

dbmcli -d DEMODB

dbmcli on DEMODB>user_logon OLEG,MONDAY

OK

Starting a DBM server session with the database instance MAXDB and on the remote computer GENUA and logging on as Database Manager operator OLEG with the password MONDAY:

dbmcli -d MAXDB – n GENUA

dbmcli on GENUA: MAXDB>user_logon OLEG,MONDAY

OK

One Step Logon with User Key and Execution of a DBM Command

Logging on to the Database Manager CLI as Database Manager operator under the key name OLKEY, connecting to the DEMODB local database instance, displaying the operating state of the database instance

dbmcli –U OLKEY –d DEMODB db_state

OK

State

OFFLINE

One Step Logon with Name and Password of a Database Manager Operator and Execution of a DBM Command

Logging on to the Database Manager CLI as Database Manager operator OLEG with password MONDAY, connecting to the local database instance DEMODB, displaying the operational state of the database instance.

dbmcli –u OLEG,MONDAY –d DEMODB db_state

OK

State

OFFLINE

 

 

Leaving content frame