Data Link Tool

 

To access information in DB2 servers using the Data Provider, you must first configure connection information in the form of a data source definition. The Data Link Tool can save a data source definition as an OLE DB universal data link (UDL) file. The data source definition is used by SQL Server data consumer programs, such as SQL Server Integration Services, to connect to a target DB2 server at runtime.

You can use the Microsoft Data Link tool to create and modify a data source definition, which can then be saved in the form of a universal data link (UDL) file. You can run the Data Links tool by clicking on a UDL file from Windows Explorer

Use the Provider tab to select the Microsoft OLE DB Provider for DB2 (the provider name string) from a list of possible OLE DB providers.

Use the Connection tab to configure the basic properties required to connect to a data source. This section describes the properties that are specific to Microsoft OLE DB Provider for DB2 v5.0 connections.

Data Source

Specify a string to describe the data source.

You must select TCP/IP Connection from the drop-down list. The Microsoft OLE DB Provider for DB2 v5.0 does not support an LU6.2 APPC connection. Once you select TCP/IP Connection, click the ellipsis (…) to open the dialog box for configuring TCP/IP network settings.

TCP/IP Network Settings

The Data Provider requires an IP address or IP alias in either IPv4 or IPv6 format, when you connect to the IBM DB2 database server by using a TCP/IP network connection. The Data Provider requires an IP network port number, when you connect to the IBM DB2 database server by using a TCP/IP network connection. For DB2/400, the default value is TCP/IP port 446. Other IBM DB2 platforms support multiple concurrent database instances, each with a unique TCP/IP port number.

When you use Secure Sockets Layer (SSL) or Transport Layer Security (TLS) encryption, you must enter a value for certificate common name.

The Security method property enables you to configure one of three security methods: Interactive sign-on, Single sign-on, or Kerberos. The configuration controls in the Security options group change depending on which Security method option that you select.

Data Provider relies on a username and password stored in a configuration file or data consumer configuration store. For example, a Universal Data Link (UDL) file is a configuration file.

User name

  • DB2 for z/OS accepts an 8 byte string.

  • DB2 for i5/OS accepts a 128 byte string.

  • DB2 for Linux or UNIX accepts an 8 byte string.

  • DB2 for Windows accepts a 30 byte string.

Password

  • DB2 for z/OS accepts an 8 byte string.

  • DB2 for i5/OS accepts a 128 byte string.

  • DB2 for Linux or UNIX accepts an 8 byte string.

  • DB2 for Windows accepts a 32 byte string.

You can save the password in a UDL or text file by clicking the Allow saving password check box.

System_CAPS_ICON_warning.jpg Warning

Authentication information, such as user names and passwords, is saved in plain text in a UDL or text file. Encryption of UDL or text files is not supported.

Data Provider relies on a username and password stored in an encrypted Enterprise Single Sign-On database.

Affiliate application

Data Provider requires a string value for Affiliate Application, when supporting the optional Enterprise Single Sign-On (SSO) security mechanism. Affiliate applications are logical entities that represent a system or sub-system such as a host, back-end system, or IBM DB2 database server. Contact your SSO administrator for the SSO Affiliate Application name. For more information, see Understanding Enterprise Single Sign-On (http://msdn.microsoft.com/library/aa754070(v=BTS.10).aspx).

Data Provider relies on a ticket that contains encrypted credentials.

Principal name

Required for use with Kerberos authentication.

Initial catalog

The Data Provider uses this value to connect to an initial catalog on the DB2 database server.

  • DB2 for z/OS accepts a 16 byte string (catalog is also known as a location).

  • DB2 for i5/OS accepts an 18 byte string (catalog is also known as a relational database).

  • DB2 for LUW accepts an 8 byte string (catalog is also known as a database).

Package collection

The Data Provider requires this value to create packages with static SQL statements (example: CREATE CURSOR), that are used to retrieve data when querying the database.

  • DB2 for z/OS accepts a 128 byte string (schema is also known as a collection).

  • DB2 for i5/OS accepts a 10 byte string (schema is also known as a collection or library).

  • DB2 for LUW accepts a 30 byte string.

The Data Provider creates packages using one of the following options.

  • Automatic for single-user environment. At runtime, the Data Provider creates and binds a single package for the current isolation level (the default is cursor stability). The Data Provider grants execute permissions to the current user.

  • Manual for multi-user environment. At design-time when you use the Data Access Tool menu option, Data Source Wizard, Data Access Library or Data Links, the Data Provider creates and binds a set of 4 packages (5 packages for DB2 for i5/OS). The Data Provider grants execute permissions to the PUBLIC group.

The Data Provider creates 4-5 packages, depending on database server platform and environment. The following table describes the packages and isolation levels.

Microsoft Package NameDB2 Isolation Level NameOLE DB Isolation Level Name
MSNC001NO COMMITN/A (DB2 for i5/OS only)
MSUR001UNCOMMITTED READISOLATIONLEVEL_READUNCOMMITTED
MSCS001CURSOR STABILITYISOLATIONLEVEL_READCOMMITTED
MSRS001READ STABILITYISOLATIONLEVEL_REPEATABLEREAD
MSRR001REPEATABLE READISOLATIONLEVEL_SERIALIZABLE

Default schema

DB2 database objects are organized into logical groups called schemas. The schema name is used to catalog SQL objects such as tables and views, using a two-part naming convention <SCHEMA>.<OBJECTNAME>. At design time, to construct SQL such as SELECT statements, SQL Server consumers can present to the user a list of all objects in the database catalog. Optionally, you can specify a string to instruct the Data Provider to restrict schema queries to a single database schema, which improves efficiency and performance. The default is an empty string.

  • DB2 for z/OS accepts a 128 byte string (schema is also known as a collection).

  • DB2 for i5/OS accepts a 10 byte string (schema is also known as a collection or library).

  • DB2 for LUW accepts a 30 byte string.

The Connection tab includes three buttons:

  • The Browse button opens an existing UDL file.

  • The Packages button instructs the Data Provider to create packages on the DB2 database server.

  • The Test connection button instructs the Data Provider to connect to the remote IBM DB2 database server by using the defined network connection.

This section describes the properties that you can configure in the Advanced tab.

DBMS Platform

Optionally, to increase performance and reduce impact to the remote database, select the data source platform on which the remote DB2 database is deployed. The Data Provider uses this value to convert data types to a format supported by this platform.

The default value is DB2/MVS (which refers to DB2 for z/OS). Other values include DB2/400 (which refers to DB2 for i5/OS), DB2/NT (which refers to DB2 for Windows), and DB2/6000 (which refers to DB2 for Linux or UNIX).

Default Qualifier

DB2 database objects are organized into logical groups called schemas. The schema name is used to identify SQL objects such as tables and views, using a two-part naming convention <SCHEMA>.<OBJECTNAME>. SQL Server consumers may issue SQL statements with one-part or unqualified object names. Optionally, you can specify a string to instruct the Data Provider to set an environment option for a default qualifier, with which to inform the DB2 server in which schema to locate database objects. The default is an empty string.

  • DB2 for z/OS accepts a 128 byte string (schema is also known as a collection).

  • DB2 for i5/OS accepts a 10 byte string (schema is also known as a collection or library).

  • DB2 for LUW accepts a 30 byte string.

Host CCSID

The Data Provider requires a value for Host CCSID (Coded Character Set Identifier) with which to perform code page conversions on string data. The default Host CCSID value is EBCDIC – U.S./Canada [37]. Typically, IBM DB2 database servers for z/OS and i5/OS utilize EBCDIC (Extended Binary Coded Decimal Interchange Code).For more information, see SNA Internationalization Programmer's Reference (http://go.microsoft.com/fwlink/?LinkID=181017).

PC Code Page

The Data Provider requires a value for PC Code Page with which to perform code page conversions on string data. The default PC code page is ANSI – Latin I [1252]. Typically, data consumers use either ANSI (American National Standards Institute) or Unicode. For more information, see SNA Internationalization Programmer's Reference (http://go.microsoft.com/fwlink/?LinkID=181017).

Read only

Optionally, the Data Provider can declare the read-only access method when connecting to the DB2 database server.

Distributed transactions

Optionally, to enlist the Data Provider in distributed transactions, you can select this property to support two-phase commit protected DB2 DUW (distributed unit of work). You must enable MSDTC to support XA transactions. For more information, see http://go.microsoft.com/fwlink/p/?linkid=217339.

The All Properties dialog lets you configure more detailed and optional properties. These properties may be edited by selecting a property from the list, and then selecting or editing the value in the right column. You can edit the following properties from this dialog.

Data Source Wizard property nameData Source Wizard dialog(s)Data Links dialog(s)Description
Affiliate ApplicationSecurityConnectionThis property instructs the Data Provider to retrieve credentials from an Enterprise Single Sign-On database.
Alternate TP NameAllAllThis property is disabled in the Microsoft OLE DB Provider for DB2 v5.0. It is enabled with the version of the provider that is used with Host Integration Server 2013.
APPC Local LU AliasAllAPPC Network SettingsThis property is disabled in the Microsoft OLE DB Provider for DB2 v5.0. It is enabled with the version of the provider that is used with Host Integration Server 2013.
APPC Mode NameAllAPPC Network SettingsThis property is disabled in the Microsoft OLE DB Provider for DB2 v5.0. It is enabled with the version of the provider that is used with Host Integration Server 2013.
APPC Remote LU AliasAllAPPC Network SettingsThis property is disabled in the Microsoft OLE DB Provider for DB2 v5.0. It is enabled with the version of the provider that is used with Host Integration Server 2013.
APPC Security TypeAllAPPC Network SettingsThis property is disabled in the Microsoft OLE DB Provider for DB2 v5.0. It is enabled with the version of the provider that is used with Host Integration Server 2013.
AuthenticationSecurityAllSets the authentication method for the connection. The default value is Server, which is authentication based on a username and password with no encryption. Server_Encrypt_Pwd instructs the Data Provider to encrypt the password only. Server_Encrypt_UsrPwd instructs the Data Provider to encrypt both the username and password. Data_Encrypt instructs the Data Provider to encrypt the username, password, and data. Warning: The Data Provider can encrypt authentication using either strong 256-bit Advanced Encryption Standard (AES) or weak 56-bit Data Encryption Standard (DES), depending on the remote DB2 server configuration. We recommend that you use a security method that uses strong authentication encryption, such as AES, Kerberos, SSL V3.0 or TLS V1.0.The Data Provider can encrypt data using weak 56-bit Data Encryption Standard (DES). We recommend that you use a security method that uses strong data encryption, such as SSL V3.0 or TLS V1.0.
Auto CommitAllAll (AutoCommit)Optionally, you can instruct the Data Provider to execute an implicit COMMIT on all SQL statements by specifying TRUE. By default, this Boolean property is set to FALSE. The AutoCommit mode can reduce the network flow and may improve overall performance. AutoCommit mode is appropriate for most common transactions that consist of a single SQL statement. However, this mode does not allow for unit of work rollback. For more information, see http://support.microsoft.com/kb/218590.
Binary Code PageAllAll (Binary Codepage)This property is disabled in the Microsoft OLE DB Provider for DB2 v5.0.
Cache AuthenticationAllAllOptionally, you can specify TRUE to instruct the data consumer or service component to cache sensitive authentication information, such as password, in an internal cache. By default, this Boolean value is set to FALSE. Service components, such as OLE DB resource pooling, require this property to set to TRUE.
Certificate Common NameTCP/IP Network ConnectionTCP/IP Network SettingsOptionally, you can specify a server certificate common name to instruct the Data Provider to use Secure Sockets Layer (SSL) V3.0 or Transport Layer Security (TLS) V1.0 encryption. Using SSL or TLS will improve security by encrypting authentication credentials and data. By default, this value is set to empty string (no SSL or TLS).
Client AccountingAllAllOptionally, you can specify a 200-byte string to instruct the Data Provider to submit client accounting information when connecting to the IBM DB2 database server. DB2 administrators can use this information for accounting, logging and troubleshooting purposes. By default this value is an empty string (do not submit any data).
Client Application NameAllAllOptionally, you can specify a 32-byte string to instruct the Data Provider to submit a client application name when connecting to the IBM DB2 database server. DB2 administrators can use this information for accounting, logging and troubleshooting purposes. By default this value is an empty string (do not submit any data).
Client User IDAllAllOptionally, you can specify a 16-byte string to instruct the Data Provider to submit a client user identifier when connecting to the IBM DB2 database server. DB2 administrators can use this information for accounting, logging and troubleshooting purposes. By default this value is an empty string (do not submit any data).
Client Workstation NameAllAllOptionally, specify an 18-byte string to instruct the Data Provider to submit a client workstation name when connecting to the IBM DB2 database server. DB2 administrators can use this information for accounting, logging and troubleshooting purposes. By default this value is an empty string (do not submit any data).
Connect TimeoutAllAllOptionally, you can specify a number of seconds, to instruct the Data Provider to wait to establish connections using client-side pooling. When all connections in a pool are in use and the timeout period expires, then the Data Provider will return an error to the data consumer (“connection not available”). The default is 15 seconds. There is no upper limit for the Connect Timeout property. Specify -1 to instruct the Data Provider to wait indefinitely for an open connection in the client-side connection pool.
Connection PoolingAdvanced OptionsAllOptionally, you can specify TRUE to instruct the Data Provider to use client-side connection pooling. The default is FALSE (no pooling).
a SourceSaving InformationConnectionAn optional parameter that can be used to describe the data source. There is no default value.
Database NameDB2 DatabaseAllOptionally, you can specify an 8-byte string to instruct the Data Provider to utilize an IN DATABASE clause in SQL statements. DB2 administrators can divide DB2 for z/OS into multiple logical databases for each containing separate table spaces and index spaces. The default is an empty string.
DateTime As CharAllAllOptional OLE DB data source initialization property that instructs the Data Provider to expose DB2 DATE, TIME, and TIMESTAMP columns as character columns using IdbSchemaRowsets::GetSchemas (DBSCHEMA_COLUMNS). This instructs the Data Provider to treat DB2 DATE, TIME, and TIMESTAMP column values as string literals. You must use the optional DateTime As Char connection option to enable Distributed Query Processor and other SQL Server consumers to select a DB2 default DATE value (0001-01-01) in a DATE or TIMESTAMP column.The default value for this Boolean property is false. You can set this property in the initialization string DateTime As Char=True or on the Data Links All tab. This property is exposed in the Data Source Wizard All Properties screen. Warning: You cannot use both DateTime As Char=True and DateTime As Date=True in the same connection. To use these two features, you must use separate connections.
DateTime As DateAllAllOptional OLE DB data source initialization property that instructs the Data Provider to delete the time information in the value of the SQL Server datetime data value, passing only the date information to the IBM DB2 database.

You must use the optional DateTime As Date connection option to allow the distributed query processor and other SQL Server consumers to write SQL Server datetime data values using INSERT and UPDATE statements, or to use SQL Server datetime data values in parameters using SELECT, INSERT, UPDATE, and DELETE statements. The default value is false. You can set this property in the initialization string DateTime As Date=True or on the Data Links All tab. This property is exposed in the Data Source Wizard All Properties screen. Warning: You cannot use both DateTime As Char=True and DateTime As Date=True in the same connection. To use these two features, you must use separate connections.
DBMS PlatformData Source (aka Data source platform)AdvancedOptionally, you can instruct the Data Provider to connect the IBM DB2 database servers based on a relational database management systems platform designation. The Data Provider supports these string values: DB2/MVS, DB2/400, DB2/6000, and DB2/NT. The default is DB2/MVS.
Decimal As NumericAllAllOptional OLE DB data source initialization property that instructs the Data Provider to map DB2 Decimal (OLE DB DBTYPE_DECIMAL) to DB2 Numeric (DBTYPE_NUMERIC). This option allows OLE DB consumers that support DBTYPE_NUMERIC but not DBTYPE_DECIMAL to read and write DB2 Decimal data. The default value is false. You can set this property in the initialization string Decimal As Numeric=True or on the Data Links All tab. This property is exposed in the Data Source Wizard All Properties screen.
Default QualifierDB2 DatabaseConnectionDB2 database objects are organized into logical groups called schemas. The schema name is used to identify SQL objects such as tables and views, using a two-part naming convention <SCHEMA>.<OBJECTNAME>. SQL Server consumers may issue SQL statements with one-part or unqualified object names. Optionally, you can specify a string to instruct the Data Provider to set an environment option for a default qualifier, with which to inform the DB2 server in which schema to locate database objects. The default is an empty string.

- DB2 for z/OS accepts a 128 byte string (schema is also known as a collection).
- DB2 for i5/OS accepts a 10 byte string (schema is also known as a collection or library).
- DB2 for LUW accepts a 30 byte string.
Default SchemaDB2 DatabaseConnectionDB2 database objects are organized into logical groups called schemas. The schema name is used to catalog SQL objects such as tables and views, employing a two-part naming convention <SCHEMA>.<OBJECTNAME>. At design time, to construct SQL such as SELECT statements, SQL Server consumers can present to the user a list of all objects in the database catalog. Optionally, you can specify a string to instruct the Data Provider to restrict schema queries to a single database schema, which improves efficiency and performance. The default is an empty string.

- DB2 for z/OS accepts a 128 byte string (schema is also known as a collection).
- DB2 for i5/OS accepts a 10 byte string (schema is also known as a collection or library).
- DB2 for LUW accepts a 30 byte string.
er PrepareAdvanced OptionsAllOptionally, you can specify TRUE to instruct the Data Provider to optimize the processing of parameterized database commands. The default value is FALSE.. For the INSERT, UPDATE, and DELETE commands, the Data Provider can combine PREPARE, EXECUTE, and COMMIT commands into one network flow to the remote database. For the SELECT command, the Data Provider combines PREPARE and EXECUTE commands into one network flow. This optimization minimizes network traffic and can improve overall performance.
Derive ParametersAdvanced OptionsAllThe Data Provider will verify and correct parameter lengths for character data types, on behalf of data consumers such as SQL Server Integration Services package designer and import/export wizard. Optionally, you can specify FALSE to instruct the Data Provider to not derive parameter data types. The default is TRUE. This feature is not required when you are using SQL Server Replication Services or other SQL Server consumers.
Extended PropertiesAllAllOptionally, you can specify additional comma-separated property value pairs that the consumer will pass to the Data Provider at connection time.
Host CCSIDLocaleAdvancedThe Data Provider requires a value for Host CCSID (Coded Character Set Identifier) with which to perform code page conversions on string data. The default Host CCSID value is EBCDIC – U.S./Canada [37]. Typically, IBM DB2 database servers for z/OS and i5/OS utilize EBCDIC (Extended Binary Coded Decimal Interchange Code). For more information, see SNA Internationalization Programmer's Reference (http://go.microsoft.com/fwlink/?LinkID=181017).
Initial CatalogDB2 DatabaseConnectionThe Data Provider requires this value to connect to an initial catalog on the DB2 database server.DB2 for z/OS accepts a 16 byte string (catalog is also known as a location). DB2 for i5/OS accepts an 18 byte string (catalog is also known as a relational database). DB2 for LUW accepts an 8 byte string (catalog is also known as a database).
Integrated SecuritySecurity (aka Single sign-on)Connection (aka Single sign-on)Optionally, you can specify SSPI to instruct the Data Provider to use Enterprise Single Sign-On or Kerberos authentication. When using ESSO, you need to specify a concurrent string value for the separate Affiliate Application property. When using Kerberos, you need to specify a concurrent string value for Principle Name.
LoadBalancingAllAllInstructs the Data Provider to utilize the server list returned by a DB2 for z/OS database server, to re-connect to the most available server in a data sharing group, in support of client transaction load balancing and fault tolerant failover. The default value for this property is FALSE.
Max Pool SizeAllAllOptional OLE DB data source initialization property that specifies the maximum number of connections that can exist in the connection pool when connection pooling is enabled for the data source. The default is 100. There is no upper limit for the Max Pool Size property. If you configure a value that is less than 0 for the Max Pool Size property, the default value of 100 is used.
Mode(aka Read only)AllOptionally, you can specify read to instruct the Data Provider to declare read-only access method when connecting to the DB2 database server. The default is read/write.
Network AddressTCP/IP Network ConnectionTCP/IP Network SettingsThe Data Provider requires an IP address or IP alias in either IPv4 or IPv6 format, when connecting to the IBM DB2 database server using a TCP/IP network connection.
Network PortTCP/IP Network ConnectionTCP/IP Network SettingsThe Data Provider requires an IP port number, when connecting to the IBM DB2 database server using a TCP/IP network connection. For DB2/400, the default value is TCP/IP port 446. Other IBM DB2 platforms support multiple concurrent database instances, each with a unique TCP/IP port number.
Network Transport LibraryData SourceConnectionThe Data Provider supports TCP/IP network connections to remote IBM DB2 database servers. The SNA LU6.2 (APPC) network connection option is disabled in the Microsoft OLE DB Provider for DB2 v5.0. It is enabled with the version of the provider that is used with Host Integration Server.
PasswordSecurityAllOptionally, you can specify a string value to instruct the Data Provider to use PCM (Password Change Management) to replace an existing password with a new password. The following table describes the DB2 database version and accepted string types.
Package CollectionDB2 DatabaseConnectionThe package collection is required to instruct the Data Provider into which DB2 schema to create a set of packages. Each package is divided into sections with static SQL statements, such as CREATE CURSOR, used to retrieve data when querying the database.
PasswordSecurityConnectionInteractive sign-on security relies on a username and password that you enter at runtime or that is stored in a configuration file or data consumer configuration store, such as an Integration Services package.
PC Code PageLocaleAdvancedThe Data Provider requires a value for PC Code Page with which to perform code page conversions on string data. The default PC code page is ANSI – Latin I [1252]. Typically, data consumers use either ANSI (American National Standards Institute) or Unicode. For more information, see SNA Internationalization Programmer's Reference (http://go.microsoft.com/fwlink/?LinkID=181017).
Persist Security InfoSecurityConnectionOptionally, you can specify TRUE to instruct the data consumer or service component to persist security information, such as password, together with other authentication information. By default, this Boolean value is set to FALSE. Choosing this option saves the user name and password in plain text. It is not possible to encrypt the user name or password using this method. Server security can be compromised if an attacker can gain access to the file share on which the UDL or text file is located.
Principal NameSecurityConnectionThis property is required for use with Kerberos authentication.
Process Binary As CharacterLocaleAdvancedThe optional Process binary (CCSID 65535) as character instructs the Data Provider to convert DB2 bytes to and from Windows character strings, based on an optional Binary Code Page.
Read OnlyAdvanced OptionsAdvancedOptionally, you can specify read to instruct the Data Provider to declare read-only access method when connecting to the DB2 database server. The default is FALSE.
Rowset Cache SizeAllAllOptional OLE DB data source initialization property that instructs the Data Provider to pre-fetch rows from DB2 while concurrently processing and returning rows to the data consumer on calls to IRowset::GetNextRows. This feature may improve performance in bulk read-only operations on multiprocessor computers. The default value for this property is 0, which indicates that the optional pre-fetch feature is off. We recommend setting a value between 50 and 200, with an initial recommended value of 100. This instructs the Data Provider to pre-fetch up to the specified number of row batches, which are stored in the Data Provider's rowset cache. The size of the row batches is automatically determined based on the value for cRows on the OLE DB IRowset::GetNextRows interface specified by the consumer. You can set this property from the Advanced Options page of the Data Source Wizard, or from the All tab of the Data Links dialog box. You can also specify this property in an OLE DB initialization string or connection string by setting Rowset Cache Size=100.
Shadow CatalogAllAllOptionally, you can specify TRUE to instruct the Data Provider to retrieve schema information from a DB2 shadow catalog, which can improve concurrent access to metadata and increase performance. The default is FALSE.
Units of WorkTCP/IP Network Connection (Distributed transactions)Advanced (Distributed transactions)The Microsoft OLE DB Provider for DB2 v5.0 supports a value of RUW, defined as Remote Unit of Work. The Data Provider that is used with Host Integration Server supports both RUW and DUW, which is defined as two-phase commit protected Distributed Unit of Work.
Use Early MetadataAllAllInstructs the Data Provider to use early metadata (parameter and column data types) defined at design time or late metadata defined at runtime. This optional property accepts a Boolean value. The default value is false. Optionally, specify true when working with data consumer programs that offer a design time option to derive data types or verify the early metadata. Specify true when using SQL Server Integration Services and Distributed Query Processor four-part linked server queries. Specify true when using DB2 BLOB, CLOB, XML, NUMERIC, and UDT with most other data consumers. Specify true when using FastLoad with SQL Server Integration Services to INSERT data into TIMESTAMP columns.
User IDSecurityConnectionInteractive sign-on security relies on a username and password that the user enters at runtime or that is stored in a configuration file or data consumer configuration store, such as an Integration Services package.
Show: