Microsoft KB Archive/318941

= PRB: BizTalk Server File Receive Function Intermittently Fails and Becomes Disabled =

Article ID: 318941

Article Last Modified on 6/4/2003

-

APPLIES TO


 * Microsoft BizTalk Server 2000 Standard Edition
 * Microsoft BizTalk Server 2002 Standard Edition

-



This article was previously published under Q318941



IMPORTANT: This article contains information about modifying the registry. Before you modify the registry, make sure to back it up and make sure that you understand how to restore the registry if a problem occurs. For information about how to back up, restore, and edit the registry, click the following article number to view the article in the Microsoft Knowledge Base:

256986 Description of the Microsoft Windows Registry



SYMPTOMS
A BizTalk Server File receive function is disabled at random intervals and an error that is similar to the following one is logged in the BizTalk Server Application log:

Event Type: Error

Event Source: BizTalk Server

Event Category: Document Processing

Event ID: 324

Date: 2/27/2002

Time: 12:01:01 PM

User: N/A

Computer: BIZTALKSERVER

Description:

An error occurred in BizTalk Server.

Details:

--

There was a serious failure in the receive function &quot;FileReceive&quot;. This receive service will be shut down, please check the event log for additional error messages.

Unspecified error

The receive function &quot;FileReceive&quot; has experienced problems, it will be shut down and disabled. Once these problems have been corrected, re-enable this receive function in BizTalk Server Administration. There was a failure processing the &quot;FileReceive&quot; receive function. Check your receive function configuration in BizTalk Server Administration.



CAUSE
This error may occur if a program gains a file lock to the file that BizTalk Server is attempting to delete after the file has been successfully handed off to a channel for processing. This error may occur if you have configured antivirus software to scan the folders that a BizTalk File receive function is monitoring.



RESOLUTION
WARNING: If you use Registry Editor incorrectly, you may cause serious problems that may require you to reinstall your operating system. Microsoft cannot guarantee that you can solve problems that result from using Registry Editor incorrectly. Use Registry Editor at your own risk.

To resolve this behavior:  Configure your antivirus software so that it does not monitor the directories that a BizTalk File receive function monitors.

-or- If you are using BizTalk Server 2002, you can make the following registry key entries to configure BizTalk Server to retry attempts to delete a file from the file receive folder after it has been successfully handed off to a channel for processing:

NOTE: BizTalk Server 2002 adds support for registry entries that allow BizTalk to retry deleting a file after processing by the File receive function. This prevents the File receive function from failing in the event that it cannot delete a file that it has processed.  Start Registry Editor (Regedt32.exe). Locate and click the following key in the registry:

\HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\BTSSVC

 On the Edit menu, click Add Value, and then add the following registry value to configure the number of retries:

Value name: FileRecSrvDeleteRetries

Data type: REG_DWORD

Radix: Decimal

Value data:

 On the Edit menu, click Add Value, and then add the following registry value to configure the retry interval:

Value name: FileRecSrvDeleteRetryInterval

Data type: REG_DWORD

Radix: Decimal

Value data:

</li> Quit Registry Editor.</li></ol> </li></ul>

<div class="moreinformation_section">

Steps to Reproduce the Behavior

 * 1) A file is dropped into the folder that the File receive function monitors.
 * 2) The Microsoft Windows 2000 file system generates a notification that indicates that a file was dropped into the folder.
 * 3) The BizTalk File receive function receives the file system notification, and then it takes the file.
 * 4) BizTalk sends the file to a channel for processing.
 * 5) Because BizTalk has successfully handed off the file to a channel for processing, BizTalk attempts to delete the file from the folder that the File receive function monitors.
 * 6) BizTalk cannot delete the file because the antivirus software has gained a lock on the file.

The BizTalk File receive function fails and disables itself, which generates the error in the BizTalk Server Application log.

Keywords: kbnofix kbprb KB318941

-

[mailto:TECHNET@MICROSOFT.COM Send feedback to Microsoft]

© Microsoft Corporation. All rights reserved.