ted-ross commented on a change in pull request #532: DISPATCH-1381: Create
procedure for handling undeliverable messages
URL: https://github.com/apache/qpid-dispatch/pull/532#discussion_r303589676
##########
File path: docs/books/user-guide/routing.adoc
##########
@@ -551,6 +551,87 @@ autoLink {
For information about additional attributes, see
link:{qdrouterdConfManPageUrl}#_autolink[autoLink] in the `qdrouterd.conf` man
page.
--
+=== Handling Undeliverable Messages for an Address
+
+You handle undeliverable messages for an address by configuring _fallback
destinations_.
+A fallback destination is a queue on a broker that stores messages that are
not directly routable to any consumers.
+
+During normal message delivery,
+{RouterName} delivers messages to the consumers that are attached to the
router network.
+However, if no consumers are reachable,
+the messages are diverted to any fallback destinations that were configured
for the address.
Review comment:
... any fallback destinations that are attached for the address...
It's possible that the auto-links are inactive, in which case messages
aren't delivered anywhere. Also, it is possible for a fallback destination to
attach by itself (using the qd.fallback capability) without using an auto-link.
----------------------------------------------------------------
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
For queries about this service, please contact Infrastructure at:
us...@infra.apache.org
With regards,
Apache Git Services
---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscr...@qpid.apache.org
For additional commands, e-mail: dev-h...@qpid.apache.org
