SET CONNECTION statement [DBISQL] [ESQL]

Description

Changes the active database connection.

Syntax

SET CONNECTION [connection-name]

Parameters

connection-name:

identifier, string or host-variable

Examples

Example 1

EXEC SQL SET CONNECTION :conn_name;

Example 2

SET CONNECTION conn1 ;

Usage

The SET CONNECTION statement changes the active database connection to connection-name. The current connection state is saved and will be resumed when it again becomes the active connection. If connection-name is omitted and there is a connection that was not named, that connection becomes the active connection.

NoteWhen cursors are opened in Embedded SQL, they are associated with the current connection. When the connection is changed, the cursor names will not be accessible. The cursors remain active and in position and will become accessible when the associated connection becomes active again.


Side effects

None.

Standards

Permissions

None.

See also