Advanced error handling configuration

Advanced error handling configuration

In Link whenever errors occur while processing documents, the error is interpreted by the Links error handling module, and the document(s) that have failed will be updated to status “Failed” where it will have information about the error that occurred. However, there are scenarios where failures occur before the documents have been saved in the database. This is often because the database is inaccessible for some reason. In these scenarios, the message will be suspended in BizTalk as resumable instances. When resumed, the message will be attempted to be saved in the database, and the document processing will continue. It is made possible to set up a retry interval, so that BizTalk will try to do this automatically a given number of times with a given timespan between attempts. With this in place, if the database where to be inaccessible for 20 minutes for some reason, the messages would eventually be saved and documents would be processed without the need for taking manual action.


This is setup in the app.config file of BizTalk. The reason it is placed here, is because it would not be wise to store them in the database, since their relevance is high when the database is inaccessible. Note that if your BizTalk environments are running both 32bit and 64bit hosts, you need to add these keys to both BTSNTSvc.exe.config and BTSNTSvc64.exe.config.Setup

  • ErrorHandling_TrackedDocs_RetryCount
    This represents the number of times the error handling will retry updating information about an error that occurred regarding a document that is stored in the database. If this key is not present, the default value 0 will be applied.
  • ErrorHandling_TrackedDocs_RetryInterval_Mins
    This represents the timespan between retry attempts for handling errors for documents that exists in database. This is specified as an integer representing the number of minutes. If not specified, the default value 5 will be applied if needed.
  • ErrorHandling_NotTrackedDocs_RetryCount
    This represents the number of times the error handling will retry handling a message that has failed prior to being persisted, by creating it as a new document in the database, and starts its processing. If this key is not present the default value 0 will be applied.
  • ErrorHandling_NotTrackedDocs_RetryInterval_Mins
    This represents the timespan between retries of storing a message in the database. This is the number of minutes between attempts. If not specified, the default value 5 will be applied if needed.


Content on this page:

The information on this page is based on Link 2.12