PRB: SubmitSync() Call Fails To Use Configured Retries (288860)



The information in this article applies to:

  • Microsoft BizTalk Server 2000

This article was previously published under Q288860

SYMPTOMS

When you use the SubmitSync() method of the IInterchange interface, you may notice that even though you have the channel configured to retry document delivery, if an error occurs, the document is immediately placed into the Suspended Queue.

CAUSE

A synchronous interchange bypasses all queues and executes all the components required by the messaging port on the calling thread. When one of these components fails and returns an error, this error is returned to the SubmitSync() call.

RESOLUTION

This behavior is by design.

MORE INFORMATION

For more information, refer to the following information in BizTalk Server 2000 Books Online:

SubmitSync returns an optional response document when provided. If no response is returned, the call returns successfully, but with no response and with an HRESULT value of S_FALSE. If the destination is another BizTalk Server, an ASP page must be used to return a response. A synchronous interchange bypasses all queues and executes all the components required by the messaging port on the calling thread. For synchronous protocols (HTTP and AIC), an optional response document is returned to the user, if available. This method is valid only for a single channel match. If the parameters set cause multiple channels to match, synchronous submission returns an error indicating that multiple channel matches are not allowed for synchronous submission. This method can be used only for single document interchanges. If the submission contains multiple documents, synchronous submission returns an error indicating that multiple document submissions are not allowed. This method does not support port groups.


Modification Type:MajorLast Reviewed:11/7/2003
Keywords:kbprb KB288860