## user_logon

### Verwendung

Der angegebene DBM-Benutzer meldet sich an das Programm Database Manager an.

Die Anmeldung an den Database Manager erfordert eine Sitzung mit dem DBM-Server der zu verwaltenden Datenbankinstanz. Sie können diese Sitzung eröffnen und sich gleichzeitig anmelden (einstufige Anmeldung) oder zunächst nur die Sitzung eröffnen und sich in einem zweiten Schritt an den Database Manager anmelden (zweistufige Anmeldung).

Die Verbindung muss immer zum DBM-Server auf dem Rechner der zu verwaltenden Datenbankinstanz hergestellt werden. Wenn sich die Datenbankinstanz auf einem entfernten Rechner befindet, müssen Sie deshalb bei der Anmeldung an den Database Manager zusätzlich den Namen des Datenbankrechners angeben.

Siehe auch:

Serverberechtigungen

Konzepte des Datenbanksystems, Database Manager-Benutzer (DBM-Benutzer)

### Zweistufige Anmeldung

Sie können zunächst die Sitzung mit dem DBM-Server eröffnen und sich in einem zweiten Schritt an den Database Manager anmelden.

...

1. Eröffnen einer DBM-Server-Sitzung:

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

dbmcli on DEMODB>

2. Anmelden an den Database Manager:

dbmcli on DEMODB>user_logon <dbm_operator>,<dbm_operator_password>

OK

dbmcli on DEMODB>

### Einstufige Anmeldung

Mit Hilfe der DBM-Option –u | -U können Sie auch beide Schritte der Anmeldung gleichzeitig ausführen. Dabei führt der Database Manager implizit das DBM-Kommando user_logon aus.

Beachten Sie die verschiedene Bedeutung der Option bei Groß- und Kleinschreibung.

#### Verwendung der DBM-Option -u

>dbmcli -u [<dbm_operator>,<dbm_operator_password>] –d <database_name> [-n <database_computer>]

· -u: explizite Angabe des mit <dbm_user_name> und <dbm_user_password> ausgewiesenen Database Manager-Benutzers

#### Verwendung der DBM-Option –U (Anmeldung mit XUSER)

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

· -U: Anmeldung mit einem in der XUSER-Datei hinterlegten Benutzer

Mit Hilfe des Programms XUSER können Sie Sets von Benutzerangaben als Benutzerschlüssel speichern und diese zur Anmeldung verwenden. Benutzerschlüssel für Database Manager-Benutzer können jedoch nur dann erfolgreich verwendet werden, wenn die darin gespeicherten Benutzer für die entsprechende Datenbankinstanz auch tatsächlich angelegt wurden (Siehe: user_create).

Wenn Sie bei –U keinen <user_key> angeben, versucht der Database Manager die Daten unter dem Benutzerschlüssel DBMUSR zu verwenden. Es empfiehlt sich deshalb, einen XUSER-Eintrag mit dem Benutzerschlüssel DBMUSR und den Daten des Database Manager-Benutzers mit den umfassendsten Berechtigungen anzulegen (Siehe: Anlegen oder Ändern von XUSER-Einträgen).

### Antwort

dbmcli on [<database_computer>] : <database_name>

Im Fehlerfall siehe Antwortformat

### Beispiele

Zweistufige Anmeldung

...

1. Aufrufen des Database Manager im Sitzungsmodus und Herstellen der Verbindung mit der lokalen Datenbankinstanz DEMODB:

>dbmcli -d DEMODB

dbmcli on DEMODB>

2. Anmelden als Benutzer OLEG mit dem Kennwort MONDAY:

dbmcli on DEMODB>user_logon OLEG,MONDAY

OK

dbmcli on DEMODB>

oder:

...

1. Aufrufen des Database Manager im Sitzungsmodus und Herstellen der Verbindung mit der Datenbankinstanz MAXDB auf dem entfernten Rechner GENUA:

>dbmcli -d MAXDB – n GENUA

dbmcli on GENUA : MAXDB>

2. Anmelden als Benutzer OLEG mit dem Kennwort MONDAY:

dbmcli on GENUA : MAXDB>user_logon OLEG,MONDAY

OK

dbmcli on GENUA : MAXDB>

Einstufige Anmeldung mit Benutzerschlüssel und Ausführen eines DBM-Kommandos

Aufrufen des Database Manager CLI, Anmelden als Benutzer unter dem Benutzerschlüssel OLKEY, Herstellen der Verbindung zur lokalen Datenbankinstanz DEMODB, Anzeigen des Betriebszustandes der Datenbankinstanz:

>dbmcli –U OLKEY –d DEMODB db_state

OK

State

OFFLINE

Einstufige Anmeldung mit Name und Kennwort eines DBM-Benutzers und Ausführen eines DBM-Kommandos

Aufrufen des Database Manager CLI, Anmelden als Benutzer OLEG mit dem Kennwort MONDAY, Herstellen der Verbindung zur lokalen Datenbankinstanz DEMODB, Anzeigen des Betriebszustandes der Datenbankinstanz:

>dbmcli –u OLEG,MONDAY –d DEMODB db_state

OK

State

OFFLINE