qpid-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From gmur...@apache.org
Subject [qpid-dispatch] branch master updated: DISPATCH-1346 - Create prioritized message delivery section in routing chapter. This closes #513
Date Tue, 02 Jul 2019 01:03:02 GMT
This is an automated email from the ASF dual-hosted git repository.

gmurthy pushed a commit to branch master
in repository https://gitbox.apache.org/repos/asf/qpid-dispatch.git

The following commit(s) were added to refs/heads/master by this push:
     new bd4e52f  DISPATCH-1346 - Create prioritized message delivery section in routing chapter.
This closes #513
bd4e52f is described below

commit bd4e52f616b5e53056c0e296aa096ae660e7af70
Author: Ben Hardesty <bhardest@redhat.com>
AuthorDate: Tue May 28 18:10:29 2019 -0400

    DISPATCH-1346 - Create prioritized message delivery section in routing chapter. This closes
 docs/books/user-guide/routing.adoc | 34 ++++++++++++++++++++++++++++++++++
 1 file changed, 34 insertions(+)

diff --git a/docs/books/user-guide/routing.adoc b/docs/books/user-guide/routing.adoc
index 4bee9ed..b3e926e 100644
--- a/docs/books/user-guide/routing.adoc
+++ b/docs/books/user-guide/routing.adoc
@@ -321,6 +321,40 @@ If a producer sends an unsettled delivery, the disposition may be ACCEPTED
or RE
+=== Configuring Addresses for Prioritized Message Delivery
+You can set the priority level of an address to control how {RouterName} processes messages
sent to that address. Within the scope of a connection, {RouterName} attempts to process messages
based on their priority. For a connection with a large volume of messages in flight, this
lowers the latency for higher-priority messages.
+Assigning a high priority level to an address does not guarantee that messages sent to the
address will be delivered before messages sent to lower-priority addresses. However, higher-priority
messages will travel more quickly through the router network than they otherwise would.
+You can also control the priority level of individual messages by setting the priority level
in the message header. However, the address priority takes precedence: if you send a prioritized
message to an address with a different priority level, the router will use the address priority
+* In the router's configuration file, add or edit an address and assign a priority level.
+This example adds an address with the highest priority level. The router will attempt to
deliver messages sent to this address before messages with lower priority levels.
+address {
+    prefix: my-high-priority-address
+    priority: 9
+    ...
+`priority`:: The priority level to assign to all messages sent to this address. The range
of valid priority levels is 0-9, in which the higher the number, the higher the priority.
The default is 4.
+.Additional resources
+* For more information about setting the priority level in a message, see the {AmqpSpecLink}.
 === Routing Messages Between Clients

To unsubscribe, e-mail: commits-unsubscribe@qpid.apache.org
For additional commands, e-mail: commits-help@qpid.apache.org

View raw message