Additional Information
Administrative Email Notifications
Processing incoming emails is a primary function of Dovetail Carrier. When an email cannot be processed it is important for application administrators to know that something went wrong. When for some reason an error is thrown by the processing on an email message.
Email Contents
The administrative email address will be sent an email describing the problem and include detailed errors information and a copy of the offending email message.
The body of the email will include a detailed description of the application exception which caused the email processing to fail.
Attached to the administrative email will be a copy of the email message (saved in the .eml format) which failed to process. Applications which can view the attached .eml include Outlook Express, Windows Live Mail, and Internet Explorer.
Reprocessing Failed Messages
When Dovetail Carrier fails to process a message it moves the message to an error queue. This queue is by default located at msmq://localhost/dovetail.carrier_errors. It is possible to replay the message by moving it back into the main Dovetail Carrier queue (default location - msmq://localhost/dovetail.carrier).
You can move messages between queues with the reprocess-errored-messages.bat batch file. Note you will need to edit the batch file if you have changed queue locations, or are running it from a different machine than the one Dovetail Carrier is installed on. Running this batch file will move all messages from the error queue into the main Dovetail Carrier queue to be reprocessed.
This batch file (and its dependencies) are contained in the following directory:
[InstallDir]\reprocess\
When the batch file executes, the messages should be reprocessed successfully. However, if the problem is still present the messages will again end back up in the error queue.
Dovetail Carrier is a flexible, customizable application and you could potentially have custom behavior which, due to some unforeseen reason, is unable to process a given message. In this case you may need to coordinate with your development team on the best way to handle the problem.
Publish Utility
Dovetail provides a publish.exe utility which will simply take some message content as an input parameter, and publish that message to Carrier.
This utility is useful for publishing messages to Carrier, which can be especially helpful when testing.
The utility, and the source code for it, are available at the Dovetail Carrier Customizations Examples site.
The following blog posts provide additional details: