Microsoft KB Archive/932770

From BetaArchive Wiki

Article ID: 932770

Article Last Modified on 12/4/2007



APPLIES TO

  • Microsoft Host Integration Server 2004 Enterprise Edition
  • Microsoft Host Integration Server 2004 Standard Edition
  • Microsoft Host Integration Server 2006
  • Microsoft OLE DB Provider for DB2




SYMPTOMS

When a consumer application uses OLE DB Provider for DB2 that is included in Microsoft Host Integration Server 2004 and in Microsoft Host Integration Server 2006 to connect to an IBM DB2 computer, the connection pooling feature that OLE DB Provider for DB2 implements does not work. This problem occurs when the following properties are configured in the connection string or in the Universal Data Link (UDL) file that the consumer application uses to connect to the DB2 computer:

  • Connection pooling=True
  • Client Application Name=<Custom Application Name>

Note This problem also occurs when you use Managed Provider for DB2.

CAUSE

This problem occurs because the connection pooling feature does not work when you use a client application name that is not the default client application name.

RESOLUTION

Host Integration Server 2004

Service Pack information

To resolve this problem, obtain the latest service pack for Host Integration Server 2004. For more information, click the following article number to view the article in the Microsoft Knowledge Base:

940313 How to obtain the latest Host Integration Server 2004 service pack


Hotfix information

A supported hotfix is now available from Microsoft. However, this hotfix is intended to correct only the problem that is described in this article. Apply this hotfix only to systems that are experiencing this specific problem. This hotfix might receive additional testing. Therefore, if you are not severely affected by this problem, we recommend that you wait for the next service pack that contains this hotfix.

To resolve this problem, submit a request to Microsoft Online Customer Services to obtain the hotfix. To submit an online request to obtain the hotfix, visit the following Microsoft Web site:

Note If additional issues occur or any troubleshooting is required, you might have to create a separate service request. The usual support costs will apply to additional support questions and issues that do not qualify for this specific hotfix. To create a separate service request, visit the following Microsoft Web site:



The English version of this hotfix has the file attributes (or later file attributes) that are listed in the following table. The dates and times for these files are listed in Coordinated Universal Time (UTC). When you view the file information, it is converted to local time. To find the difference between UTC and local time, use the Time Zone tab in the Date and Time item in Control Panel.

File name File version File size Date Time Platform
Db2oledb.dll 6.0.2072.0 488,960 14-Feb-2007 20:27 x86
Db2oledb.h Not Applicable 24,579 14-Feb-2007 20:31 Not Applicable
Ddmstr.dll 6.0.2072.0 44,032 14-Feb-2007 20:26 x86
Drdaresync.exe 6.0.2072.0 337,408 14-Feb-2007 20:27 x86
Microsoft.hostintegration.dataaccesslibrary.dll 6.0.2072.0 86,016 14-Feb-2007 20:26 x86
Microsoft.hostintegration.dataaccesstool.exe 6.0.2072.0 2,703,360 14-Feb-2007 20:27 x86
Microsoft.hostintegration.msdb2client.dll 6.0.2072.0 114,688 14-Feb-2007 20:26 x86
Mseidb2c.dll 6.0.2072.0 71,680 14-Feb-2007 20:26 x86
Mseidb2d.dll 6.0.2072.0 435,200 14-Feb-2007 20:27 x86
Mseidrda.dll 6.0.2072.0 696,320 14-Feb-2007 20:27 x86

Host Integration Server 2006

A hotfix is currently not available for Microsoft Host Integration Server 2006.

Microsoft OLE DB Provider for DB2 1.0 with Service Pack 1

A hotfix is currently not available for Microsoft OLE DB Provider for DB2 1.0 with Service Pack 1.

WORKAROUND

To work around this problem, remove the Client Application Name property from the connection string or from the UDL file that the consumer application uses to initialize the connection to the IBM DB2 computer.

STATUS

Microsoft has confirmed that this is a problem in the Microsoft products that are listed in the "Applies to" section. This problem was first corrected in Host Integration Server 2004 Service Pack 1.

MORE INFORMATION

After you apply this update, the connection pooling feature functions as expected when the Client Application Name property is used to specify a nondefault client application name.

The Client Application Name property is an optional OLE DB data source initialization property. This property is used to specify a custom application name that the DB2 network client passes to the IBM DB2 computer when the connection is made. When you troubleshoot issues, you can use this value to help determine relevant portions within DB2 logs or system logs. The following lists describe the characteristics of the Client Application Name property when the property is used in different Microsoft programs.

Microsoft OLE DB Provider for DB2

  • Property Group: Initialization
  • Property Set: DBPROPSET_DBINIT
  • Property ID: DBPROP_DB2OLEDB_CLIENTAPPNAME
  • Property Description: Client Application Name
  • Initialization Keyword: ClientAppName
  • Default Value: MSEIDRDA
  • Data Links Dialog: All
  • Type: VT_BSTR
  • Max Length: 18
  • Invalid Characters: ~`!@#$%^&*()-+=[]{}:;"',<>?|\/
  • Invalid Starting Characters: ~`!@#$%^&*()-+=[]{}:;"',<>?|\/.0123456789
  • R/W: R/W
  • Required: No

Managed Provider for DB2

  • Class: MsDb2Connection
  • Property: ClientApplicationName
  • Default Value: MSEIDRDA
  • Type: String
  • Max Length: 18
  • Invalid Characters: ~`!@#$%^&*()-+=[]{}:;"',<>?|\/
  • Invalid Starting Characters: ~`!@#$%^&*()-+=[]{}:;"',<>?|\/.0123456789
  • R/W: R/W
  • Required: No

Microsoft Data Access Library

  • Class: IConnectionString
  • Property: ClientApplicationName
  • Default Value: MSEIDRDA
  • Type: String
  • Max Length: 18
  • Invalid Characters: ~`!@#$%^&*()-+=[]{}:;"',<>?|\/
  • Invalid Starting Characters: ~`!@#$%^&*()-+=[]{}:;"',<>?|\/.0123456789
  • R/W: R/W
  • Required: No

Microsoft ODBC Driver for DB2

The Client Application Name property is not supported with the ODBC Driver for DB2.

REFERENCES

For more information, click the following article number to view the article in the Microsoft Knowledge Base:

824684 Description of the standard terminology that is used to describe Microsoft software updates


Keywords: kbfix kbqfe kbcode kbpubtypekc kbhotfixserver KB932770