Connecting to DB2 Universal Database 6.x, 7.2, and OS/390

CF Data Source Name

The data source name (DSN) used by ColdFusion MX to connect to the data source.

Database

The name of the database.

Server

The name of the server that hosts the database that you want to use. If the database is local, enclose the word local in parentheses.

Port

The number of the TCP/IP port that the server monitors for connections.

Username

The user name that ColdFusion MX 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.

The username must have CREATE PACKAGE privileges for the database, or the database administrator must create a package. Consult the database administrator when configuring this type of data source.

Password

The password (16-character limit) that ColdFusion MX 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.

For UDB on the initial connection, specify DatabaseName, PackageName, CreateDefaultPackage, and ReplacePackage, as shown in the following example:

DatabaseName=SAMPLE;PackageName=pkgname;
CreateDefaultPackage=TRUE;ReplacePackage=TRUE

For UDB on subsequent connections, specify DatabaseName and PackageName, as shown in the following example:

DatabaseName=SAMPLE;PackageName=pkgname

For OS/390 on the initial connection, specify LocationName, CollectionId, PackageName, and CreateDefaultPackage, as shown in the following example:

LocationName=SAMPLE;CollectionId=DEFAULT;
PackageName=pkgname;CreateDefaultPackage=TRUE

For OS/390 on subsequent connections, specify LocationName, CollectionId, and PackageName, as shown in the following example:

LocationName=SAMPLE;CollectionId=DEFAULT;
PackageName=pkgname

Where pkgname is the name of the package (maximum of 7 characters) that the driver uses to process SQL statements.

Your user ID must have CREATE PACKAGE privileges on the database, or your database administrator must create a package for you.

Limit Connections

Specifies whether ColdFusion MX limits the number of database connections for the data source. If you enable this option, use the Restrict Connections to field to specify the maximum.

Restrict Connections to

Specifies the maximum number of database connections for the data source. To use this restriction, you must enable Limit Connections.

Maintain Connections

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

String Format

Enable this option if your application uses Unicode data in DBMS-specific Unicode datatypes such as National Character or nchar.

Max Pooled Statements

Enables reuse of prepared statements (that is, stored procedures and queries that use the cfqueryparam tag). Although you tune this setting based on your application, start by setting it to the sum of the following:

• Unique cfquery tags that use cfqueryparam
• Unique cfstoredproc tags

Timeout (min)

The maximum number of minutes after the data source connection is made that you want ColdFusion to cache a connection after it is used.

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 unchecked, 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 unchecked, ColdFusion retrieves the amount specified in the Blob Buffer setting.

LongText Buffer (chr)

The default buffer size, used if Enable Long Text Retrieval (CLOB) is not selected. Default is 64000 bytes.

BLOB Buffer (bytes)

The default buffer size, used if Enable binary large object retrieval (BLOB) is not selected. Default is 64000 bytes.

Allowed SQL

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