Microsoft BizTalk Server 2004
Troubleshooting the File Adapter

This topic lists problems and their causes that you may encounter when using the File adapter.

Receive Location is Disabled

The File receive adapter disables the receive location if any of following occur:

  • The File receive adapter cannot access the receive location on the file system or network share because the specified path does not exist. For a network share, the File receive adapter disables the receive location after all retry attempts have been exhausted.
  • The File receive adapter cannot access the receive location on the file system or network share because it does not have read-write permission for that location. For a network share, the File receive adapter disables the receive location after all retry attempts have been exhausted.
  • Files with names longer than 256 characters are encountered in the receive location.

Files Are Not Being Read

The File receive adapter does not read a file from the receive location if any of the following conditions apply:

  • The file is read-only.
  • The file has a system attribute.
  • The File receive adapter does not have permissions to read and write to the file.

When the File receive adapter encounters such a file, it logs an error in the event log and leaves the file in the receive location.

Messages Are Not Being Sent

The File send adapter fails to send a message if any of the following occurs:

  • The File send adapter cannot access the directory that files are sent from on the file system or network share because the specified path does not exist.
  • The File send adapter cannot write to a file in the destination location on the file system or network share because it does not have write permissions for that file or for that location.
  • The File send adapter cannot write to the file specified because it is read-only or is a system file (for example, has a system file attribute).

If a message failed to be written to a file, the File send adapter reports an error in the event log and submits a message to the MessageBox database to perform following operations (in the order listed):

  • Deliver the message to the File send adapter later, so it can retry the write operation.
  1. Deliver the message to the backup adapter.
  2. Route the message to the suspended queue.

Sending files to locations that require a user name and password

Problem: You need to drop files to a location that requires a user name and password.

Cause: The File adapter does not support setting user names and passwords in its configuration properties.

Resolution: Map a network drive to the location used by the Send port, specify the user and password, and then use that network drive in the Send port address.

Sending a file using the File adapter is very slow

Problem: The File adapter is very slow when sending messages.

Cause: The Allow cache on write property is set to False by default.

Resolution: Change the Allow cache on write property to True (check the box). For more information about the Allow cache on write property, see Configuring a File Send Port By Using BizTalk Explorer.

See Also

File Adapter

To download updated BizTalk Server 2004 Help from www.microsoft.com, go to http://go.microsoft.com/fwlink/?linkid=20616.

Copyright © 2004 Microsoft Corporation.
All rights reserved.
Page view tracker