You need a utility session on the database instance to execute certain DBM commands. If you enter these DBM option additionally when you log on to the Database Manager, then the DBM command for opening a utility session is implicitly executed.
You use this DBM option to transfer the desired database user's data. The utility session is then opened with this user data for the specified database instance. When you end the Database Manager CLI, the utility session for the database instance is also ended.
Note the different meanings of the command with uppercase and lowercase specification.
-uUTL: use the database user identified by user name and password
-UUTL: use a database user’s user key stored in the XUSER file
If you do not specify a user with –uUTL, the Database Manager CLI uses the data of the first DBM operator. Opening a utility session with the first DBM operator is successful only if the DBM operator logged on to the Database Manager CLI has the server authorization required for executing the DBM command for opening a utility session.
If you do not specify a user with –UUTL, the Database Manager attempts to use the user data stored under the c XUSER key. We therefore recommend you create an XUSER entry with the key name c and the data of the first DBM operator (see:Utilities, Creating or Changing XUSER Entries).
The database user specified with the user name and password or with an XUSER key must have been created for the database instance specified, otherwise the command fails. When the utility session is opened, any database name stored under a specified XUSER key is ignored.
See also:
Utilities, XUSER
-uUTL [<database_user>,<database_user_password>] | -UUTL [<user_key>]
Options
Option |
Description |
<database_user> |
Name of the database user |
<database_user_password> |
Password of the database user |
<user_key> |
User key |
Log on to the Database Manager CLI as operator OLEG with the password MONDAY, log on to the database instance DEMODB, open a utility session as database user MONA with password RED, and back up the database instance on the backup medium DemoDataCompl:
>dbmcli –u OLEG,MONDAY–d DEMODB –uUTL MONA,RED backup_start DemoDataCompl
OK
<reply_to_backup_command>
Logging on to the Database Manager CLI as operator OLEG with the password MONDAY, connecting to the database instance DEMODB, opening a utility session as database user with the XUSER key MOKEY, and backing up the database instance on the backup medium DemoDataCompl:
>dbmcli –u OLEG,MONDAY–d DEMODB –UUTL MOKEY backup_start DemoDataCompl
OK
<reply_to_backup_command>