Entering content frame

Procedure documentation Logging On to the Database Manager Locate the document in its SAP Library structure

Use

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

For local communication, the operator is already logged on to the operating system.

Prerequisites

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.

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_server>]

       2.      Logging on to the Database Manager:

user_logon <dbm_user>,<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 different meanings of the command with upper and lower-case letters.

Using the DBM Option -u

dbmcli -u [<dbm_user>,<dbm_user_password>] –d <database_name>

·         -u: explicit specification of the DBM operator identified by <dbm_user> and <dbm_user_password>

Example

Calling the database manager CLI as DBM operator OLEG with password MONDAY, logging on to the HOTELDB database instance, querying the operational state of the database instance:

dbmcli –u OLEG,MONDAY –d HOTELDB db_state

 

Using the DBM Option –U (Logon with XUSER)

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

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

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

If you do not specify a <user_key> when using –U, the database manager attempts to use the data under the DBMUSR XUSER key. We therefore recommend that you create an XUSER entry with the key name DBMUSR and the data of the first DBM operator (see also: Creating or Changing XUSER Entries).

 

Reply

dbmcli on <database_name>>

In the event of errors, see Reply Format.

Examples

Two Step Logon

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

dbmcli -d HOTELDB

dbmcli on HOTELDB>user_logon DBM,DBM

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

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

dbmcli –U OLKEY –d HOTELDB db_state

OK

State

OFFLINE

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

Logging on to the Database Manager CLI as operator OLEG with password MONDAY, connecting to the HOTELDB database instance

dbmcli –u OLEG,MONDAY –d HOTELDB

dbmcli on HOTELDB>

Executing the DBM command for displaying the operating state of the database instance

dbmcli on HOTELDB>db_state

OK

State

OFFLINE

 

Leaving content frame