Share via


Message Acknowledgement

[This documentation is for preview only, and is subject to change in later releases. Blank topics are included as placeholders.]

You can set up your MessageQueue component to generate acknowledgement messages that tell you whether the message was successfully delivered. There are two main types of acknowledgement that you can receive:

  • Acknowledgement that the message reached its destination queue.

  • Acknowledgement that the message was retrieved from the queue by the destination application.

Within each of these scenarios, you can also receive positive or negative acknowledgement. In positive acknowledgement, you receive an acknowledgement message when your message successfully reaches its destination queue or application. In negative acknowledgement, you receive an acknowledgement message when your message fails to reach its destination queue or application. A message might fail to reach its destination if its time-out period expires or if the message cannot be authenticated.

How Acknowledgements Are Handled

As with most operations in Message Queuing, acknowledgements are handled by sending a new message to a queue. In this case, the acknowledgement message is sent from the target queue to a special type of queue called an Administration queue. Acknowledgement messages differ from standard messages in that they contain no attached body; only the information in the message header is of interest in an acknowledgement.

Note

Acknowledgement messages for your application are sent to whatever queue you specify in the AdministrationQueue property, either in the DefaultPropertiesToSend class for your component instance or on the Message object. You determine the type of acknowledgement you want to receive by setting the AcknowledgeType property to one of its predetermined values.

You can check acknowledgement messages in the same way you check any message on a queue — by peeking at the acknowledgement queue or removing messages from it. For more information, see Reading and Receiving Messages.

For instructions on setting up acknowledgement, see How to: Request Acknowledgement for Messages.

See Also

Tasks

How to: Request Acknowledgement for Messages

Other Resources

Sending and Serializing Messages

Reading and Receiving Messages