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

Article translations Article translations
Article ID: 959105 - View products that this article applies to.
Expand all | Collapse all

On This Page

SYMPTOMS

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.

RESOLUTION

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:
http://support.microsoft.com/contactus/?ws=support
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
Collapse this tableExpand this table
File nameFile versionFile sizeDateTimePlatform
Microsoft.biztalk.adapters.bizutil.dll1.0.1168.0164,22405-Nov-200817:40x86
BizTalk Server 2006 R2
Collapse this tableExpand this table
File nameFile versionFile sizeDateTimePlatform
Microsoft.biztalk.adapters.bizutil.dll1.0.5020.0162,68024-Mar-200920:54x86
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).

STATUS

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

MORE INFORMATION

For more information about BizTalk Server adapters for LOB applications, visit the following Microsoft Web site:
http://www.microsoft.com/biztalk/evaluation/adapter/default.mspx
For more informationBizTalk Server hotfixes, click the following article number to view the article in the Microsoft Knowledge Base:
2003907 Information on BizTalk Server hot fixes
For more information about Process Monitor, visit the following Microsoft Web site:
http://technet.microsoft.com/en-us/sysinternals/bb896645.aspx
For more information about software update terminology, 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

Properties

Article ID: 959105 - Last Review: November 9, 2011 - Revision: 5.0
APPLIES TO
  • Microsoft BizTalk Server 2006 Standard Edition
  • Microsoft BizTalk Server 2006 Enterprise Edition
  • Microsoft BizTalk Server 2006 Developer Edition
  • Microsoft BizTalk Server 2006 R2 Branch Edition
  • Microsoft BizTalk Server 2006 R2 Developer Edition
  • Microsoft BizTalk Server 2006 R2 Enterprise Edition
  • Microsoft BizTalk Server 2006 R2 Standard Edition
Keywords: 
kbsurveynew kbbtsadapters kbautohotfix kbexpertiseinter kbhotfixserver kbqfe KB959105

Give Feedback

 

Contact us for more help

Contact us for more help
Connect with Answer Desk for expert help.
Get more support from smallbusiness.support.microsoft.com