PRB: BizTalk Server File Receive Function Intermittently Fails and Becomes Disabled (318941)

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 "FileReceive". This receive service will be shut down, please check the event log for additional error messages.

Unspecified error

The receive function "FileReceive" 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 "FileReceive" receive function. Check your receive function configuration in BizTalk Server Administration.

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.
1. Start Registry Editor (Regedt32.exe).
2. Locate and click the following key in the registry:
  \HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\BTSSVC
3. 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: Retry number
4. 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: Retry interval in seconds
5. Quit Registry Editor.

MORE INFORMATION

Steps to Reproduce the Behavior

A file is dropped into the folder that the File receive function monitors.
The Microsoft Windows 2000 file system generates a notification that indicates that a file was dropped into the folder.
The BizTalk File receive function receives the file system notification, and then it takes the file.
BizTalk sends the file to a channel for processing.
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.
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.