FIX: Multiple RunTimeAgent processes are created when you use the Microsoft BizTalk Adapter for Oracle database to connect to an Oracle server

You use the Microsoft BizTalk Adapters for Enterprise Applications:

Microsoft BizTalk Adapter for J.D. Edwards EnterpriseOne
Microsoft BizTalk Adapter for J.D. Edwards OneWorld XE
Microsoft BizTalk ODBC Adapter for Oracle Database
Microsoft BizTalk ODBC Adapter for Oracle E-Business Suite
Microsoft BizTalk Adapter for PeopleSoft Enterprise
Microsoft BizTalk Adapter for Siebel eBusiness Applications
Microsoft BizTalk Adapter for TIBCO Enterprise Message Service
Microsoft BizTalk Adapter for TIBCO Rendezvous

You process a high volume of messages from Microsoft BizTalk Server to the back-end system.

In this scenario, multiple RunTimeAgent processes are created in Task Manager or Process Monitor. Among all the RunTimeAgent processes, only the last created RunTimeAgent process is active. Additionally, all the inactive RunTimeAgent processes do not release the resource that they are using.

Hotfix information

There are two versions of this hotfix:

• Microsoft BizTalk Server 2006
• Microsoft BizTalk Server 2006 R2

A supported hotfix is 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.

If the hotfix is available for download, there is a "Hotfix download available" section at the top of this Knowledge Base article. If this section does not appear, submit a request to Microsoft Customer Service and Support to obtain the hotfix.

Note If additional issues occur or if 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. For a complete list of Microsoft Customer Service and Support telephone numbers or to create a separate service request, visit the following Microsoft Web site: Note The "Hotfix download available" form displays the languages for which the hotfix is available. If you do not see your language, it is because a hotfix is not available for that language.

Prerequisites

This hotfix applies Microsoft BizTalk Adapters for Enterprise Applications installed on BizTalk Server 2006�BizTalk Server 2006 R2.

and BizTalk Adapters for LOB applications installed. Or, you must have BizTalk Server 2006 R2 and BizTalk Adapters for LOB applications installed.

Restart requirement

You do not have to restart your computer after you apply this hotfix.

Hotfix replacement information

This hotfix does not replace any other hotfixes.

File information

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.

BizTalk Server 2006

BizTalk Server 2006 R2

Note Because of file dependencies, the most recent hotfix that contains these files may also contain additional files.

How to use this hotfix

This hotfix updates the same DLL on BizTalk Server 2006 and on BizTalk Server 2006 R2. Please note the file version in these tables to confirm that you installed the correct version.

After you apply this hotfix, you must do the following:

1. Manually register the Microsoft.BizTalk.Adapters.BizUtil.dll file in the global assembly cache (GAC). To do this, use one of the following methods.
   
   Method 1: If you have Microsoft Visual Studio 2005 installed
   1. Click Start, point to All Programs, point to Microsoft Visual Studio 2005, point to Visual Studio Tools, and then click Visual Studio 2005 Command Prompt.
   2. At the Visual Studio command prompt, locate the following folder:
      %ProgramFiles%\Common Files\Microsoft BizTalk Adapters for Enterprise Applications\Bin
   3. At the Visual Studio command prompt, run the following command:
      gacutil /i Microsoft.BizTalk.Adapters.BizUtil.dll
   Method 2: If you do not have Microsoft Visual Studio 2005 installed
   1. Click Start, click Run, type cmd, and then click OK.
   2. At the command prompt, locate the following folder:
      %WINDIR%\Microsoft.NET\Framework\v1.1.4322
   3. At the command prompt, run the following command:
      gacutil /i "<Drive>:\Program Files\Common Files\Microsoft BizTalk Adapters for Enterprise Applications\Bin\ Microsoft.BizTalk.Adapters.BizUtil.dll"
   Note These BizTalk adapters use the Microsoft .NET Framework 1.1.
2. In the registry, follow these steps and then quit Registry Editor:
   
   Warning Serious problems might occur if you modify the registry incorrectly by using Registry Editor or by using another method. These problems might require that you reinstall the operating system. Microsoft cannot guarantee that these problems can be solved. Modify the registry at your own risk.
   1. Click Start, click Run, type regedit, and then click OK.
   2. Locate and then select the following key in the registry:
      32-bit:
      HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\BizTalkAdapters
      
      64-bit:
      HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node\Microsoft\BizTalkAdapters
   3. On the Edit menu, point to New, and then click DWORD Value.
   4. Type AgentOutboundTimeout, and then press ENTER.
   5. On the Edit menu, click Modify.
   6. Select Decimal, type 60000, and then click OK.
   The AgentOutboundTimeout value is used to recycle the RunTimeAgent processes after a certain time of inactivity. The value should be set so it is more than the time it takes for the operation to complete on the Oracle server. The default value is 60000 milliseconds (1 minute).

Microsoft has confirmed that this is a problem in the Microsoft products that are listed in the "Applies to" section.

For more information about BizTalk Server adapters for LOB applications, visit the following Microsoft Web site: For more informationBizTalk Server hotfixes, click the following article number to view the article in the Microsoft Knowledge Base: For more information about Process Monitor, visit the following Microsoft Web site:For more information about software update terminology, click the following article number to view the article in the Microsoft Knowledge Base: