Entering content frame

 Opening a Utility Session: -uUTL 

Use

A utility session for the database instance is a prerequisite for executing certain DBM commands.

If, when you log on to the Database Manager CLI using the DBM options –d (name of the database instance) and –u (DBM operator), you also specify the DBM option–uUTL, the DBM command for opening a utility session is executed implicitly.

You use the DBM option –uUTL to transfer the user data for the required database user. The utility session is 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:Uses the database user identified with the user name and password
-UUTL:Uses a user key stored in the XUSER file for a database user

See also: XUSER

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 also: 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 under the DBM option –d, otherwise the command fails.

When the SQL session is opened, any database name stored under a specified XUSER key is ignored.

Syntax

-uUTL [<database_user>,<database_user_password>]

Or log on with the XUSER key of a database user:

-UUTL [<user_key>]

Example for -uSQL

Call the Database Manager CLI, log on to the database instance HOTELDB as operator DBM with password DBM, open a utility session as database user DAVIDwith password BLUE, and back up the database instance on the backup medium CPLBM:

dbmcli –d HOTELDB –u DBM,DBM –uUTL DAVID,BLUE backup_start CPLBM

OK
<reply_to_backup_command>

Example for -USQL

Call the Database Manager CLI, log on to the database instance HOTELDB as operator DBM with password DBM, open a utility session as the database user stored under the DAKEY XUSER key, and back up the database instance on the backup medium CPLBM:

dbmcli –d HOTELDB –u DBM,DBM –UUTL DAKEY backup_start CPLBM

OK
<reply_to_backup_command>

 

 

Leaving content frame