![]() ![]() ![]() |
||
|
This section discusses using the ColdFusion MX Administrator to define data sources for DB2 Universal Database (UDB). For information on defining data sources that work with DB2 for OS/390 or iSeries, see Connecting to other data sources. To see a list of DB2 versions that ColdFusion MX supports, go to www.macromedia.com/go/sysreqscf.
Note: DB2 UDB refers to all versions of DB2 running on Windows, UNIX, and Linux/s390 platforms.
Use the settings in the following table to connect ColdFusion MX to DB2:
Setting |
Description |
---|---|
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 The user name 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 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 |
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, CreateDefaultPackage, ReplacePackage, and sendStringParametersAsUnicode (with no spaces), as the following example shows:
If the database uses Unicode, specify true for the sendStringParametersAsUnicode parameter. For UDB on subsequent connections, specify DatabaseName and sendStringParametersAsUnicode (with no spaces), as the following example shows:
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 the Limit Connections option. |
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. |
Max Pooled Statements |
Enables reuse of prepared statements (that is, stored procedures and queries that use the
|
Timeout (min) |
The number of minutes that ColdFusion MX 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 unchecked, ColdFusion retrieves the number of characters specified in the Long Text Buffer setting. For UDB 7.1 and 7.2, there is a 32K limit on CLOBs. |
BLOB |
Select to return the entire contents of any BLOB/Image columns in the database for this data source. If unchecked, ColdFusion retrieves the number of characters specified in the BLOB Buffer setting. BLOBs are not supported on UDB 7.1 and 7.2. |
LongText Buffer (chr) |
The default buffer size, used if the CLOB option is not selected. The default value is |
BLOB Buffer (bytes) |
The default buffer size, used if the BLOB option is not selected. The default value is |
Allowed SQL |
The SQL operations that can interact with the current data source. |
|
||
![]() ![]() ![]() |