CONNECT TO

Opens a new database session in multi-session mode.

Syntax

CONNECT TO { dbname | DEFAULT } [ AS session ]
    [ USER login USING auth ]
    [ WITH CONCURRENT TRANSACTION ]

dbname is the database specification.
session identifies the database session. By default, it is dbname.
login is the name of the database user.
auth is a string to authenticate the database user, like a password.

Usage

The CONNECT TO instruction opens a database connection. If the instruction successfully connects to the database environment, the connection becomes the current database session for the program.

The session name is case-sensitive.

A program can connect to several database environments at the same time (using different database drivers), and it can establish multiple connections to the same database environment, provided each connection has a unique connection name.

The connection is closed with the DISCONNECT instruction, or when the program ends.

When the USER login USING auth clause is specified, the database user is identified by login and auth, ignoring all other user settings defined in FGLPROFILE or as connection string parameters.

The auth parameter can be a simple password for internal dabase users, but for some type of database engines, it can be used to specify an external authentication token, such as a distinguished name (DN). For more details, see the SQL adaptation guide of you database type.

The WITH CONCURRENT TRANSACTION clause allows a program to open several transactions concurrently in different database sessions: The transaction can be started with the BEGIN WORK statement in a given connection context, then the program can switch to another connection with SET CONNECTION, and when done, switch back to the first connection to issue a COMMIT WORK or ROLLBACK WORK. This is supported for IBM^® Informix^® database servers. The option is ignored with other database server types, but it can be used in the CONNECT statement for consistency with Informix.

A CONNECT TO statement cannot be executed with dynamic SQL (i.e. PREPARE + EXECUTE).

With IBM Informix database servers, when using the CONNECT TO DEFAULT, you connect to the default IBM Informix database server, identified by the INFORMIXSERVER environment variable, without any database selection.

When using IBM Informix databases on UNIX™, the only restriction on establishing multiple connections to the same database environment is that an program can establish only one connection to each local server that uses the shared-memory connection mechanism. To find out whether a local server uses the shared-memory connection mechanism or the local-loopback connection mechanism, examine the $INFORMIXDIR/etc/sqlhosts file.

Example

MAIN
  DEFINE uname, upswd VARCHAR(50) 
  CONNECT TO "stores1" -- Session name is "stores1"
  CONNECT TO "stores1" AS "SA" -- Session name is "SA"
  CALL login_dialog() RETURNING uname, upswd
  CONNECT TO "stores2" AS "SB" USER uname USING upswd
END MAIN