Entering content frame

Syntax documentation USE USER Command Locate the document in the library structure

You can use the USE USER Loader command for starting a database session to create a connection with the specified information.

Syntax

<use_user_command> ::= USE USER <valUSERNAME> <valPASSWORD> [<schema_spec>] [<database_name_statement>] [<isolation_level_spec>]

<valUSERNAME>

Name of the database user

The name of the database user is automatically converted by the database system into uppercase letters. If you want to suppress the conversion, you must place the name in quotation marks.

<valPASSWORD>

Password

The password for the database user is automatically converted by the database system into uppercase letters. If you want to suppress the conversion, you must place the name in quotation marks.

<schema_spec>

SCHEMA <valSCHEMA_NAME>

Specification of the schema for the database user
If the name of the schema is identical to a keyword or if the upper- and lowercase notation is relevant, the name must be placed in quotation marks.

<database_name_statement>

SERVERDB <valDBNAME> [ON <valDBNODE> [ENCRYPTION <valPROTOCOL_NAME>]]

<valDBNAME>

Name of database instance

Valid for the entire database session with this database instance

If the name of the database instance is identical to a keyword or if the upper- and lowercase notation is relevant, the name must be placed in quotation marks.

ON <valDBNODE>

Name of the computer on which the database instance is installed for which a database session is to be started.

If this is not specified, the Loader assumes that the specified database instance was created on the computer to which the user of the Loader is logged on.

ON <valDBNODE> ENCRYPTION <valPROTOCOL_NAME>

In addition, you can specify the name of the requested encryption protocol valPROTOCOL_NAME to ensure the data transfer is encrypted. This option is currently only supported for SAP systems and SSL.

<isolation_level_spec>

ISOLATION LEVEL <valISOLATION_LEVEL>

<valISOLATION_LEVEL>

Value of the isolation level to be set
Default value: 3

Examples

Example

USE USER mona red SERVERDB demodb ON genua

Use user MONA to log on to database instance DEMODB on computer GENUA

Example

USE USER mona red SCHEMA hotel SERVERDB demodb ON genua

Use user MONA to log on to database instance DEMODB in the schema HOTEL on computer GENUA

Example

USE USER mona red SERVERDB demodb ON genua ISOLATION LEVEL 0

Set isolation level 0

Explanation

This command terminates the current connection of the Loader to the database instance and creates a new connection with the specified parameters.

<schema_spec>

You can specify in which schema the user is to be logged on. If you do not specify a schema, the user uses the schema that is assigned to him. This setting applies as long as no other schema is specified using a USE USER, USE SCHEMA or SET CURRENT SCHEMA  command.

<database_name_statement>

If you do not specify a database instance name in the USE USER command, the new connection is created to the database instance that was used prior to the USE USER command or set using option –u.

<isolation_level_spec>

You can use the USE USER command to set the isolation level for a user and override the value set by the SET ISOLATION LEVEL command. If you do not specify an isolation level, the value set for the database session is used.

The current isolation level value can also be changed using an EXPORT COLUMNS command  by specifying the appropriate LOCK option in the SELECT statement.

See also:

Starting a Database Session: Commands

Options for Establishing a Connection

 

Leaving content frame