Connect to ODBC Socket

Option

Description

CF Data Source Name

The data source name (DSN) that ColdFusion uses to connect to the data source.

ODBC DSN

Select the ODBC DSN to which you want ColdFusion to connect.

Trusted Connection

If selected, you do not have to specify the Username and Password fields. The ODBC driver for the data source uses the credentials specified in the ODBC connection or the network login id.

Username

The user name that ColdFusion passes to the JDBC driver to connect to the data source if a ColdFusion application does not supply a user name (for example, in a cfquery tag).

Password

The password that ColdFusion passes to the JDBC driver to connect to the data source if a ColdFusion application does not supply a password (for example, in a cfquery tag).

Description

(Optional) A description for this connection.

Connection String

A field that passes database-specific parameters, such as login credentials, to the data source.

Return Time Stamp as String

Enable this setting if your application retrieves Date/Time data and then reuses it in SQL statements without applying formatting (using functions such as DateFormat, TimeFormat, and CreateODBCDateTime).

Limit Connections

If selected, limits the number of data source connections to the value entered in the Restrict Connections To field.

Restrict Connections To

The maximum number of data source connections; used with the Limit Connections option.

Maintain Connections

ColdFusion establishes a connection to a data source for every operation that requires one. Select this option to improve performance by caching the data source connection.

Timeout (min)

The number of minutes that ColdFusion maintains an unused connection before destroying it.

Interval (min)

The time (in minutes) that the server waits between cycles to check for expired data source connections to close.

Disable Connections

If selected, suspends all client connections.

Login Timeout (sec)

The number of seconds before ColdFusion times out the data source connection login attempt.

CLOB

Select to return the entire contents of any CLOB/Text columns in the database for this data source. If not selected, ColdFusion retrieves the amount specified in the Long Text Buffer setting.

BLOB

Select to return the entire contents of any BLOB/Image columns in the database for this data source. If not selected, ColdFusion retrieves the amount specified in the BLOB Buffer setting.

LongText Buffer (chr)

The default buffer size, used if the CLOB option is not selected. The default value is 64000 bytes.

BLOB Buffer (bytes)

The default buffer size, used if the BLOB option is not selected. The default value is 64000 bytes.

Allowed SQL

The SQL operations that can interact with the current data source.

Validation Query

Called when a connection from the pool is resued. This can slow query response time because an additional query is generated. You should specify this just before restarting the database to verify all connections, but remove the validation query after restarting the database to avoid any performance loss.