You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@qpid.apache.org by kg...@apache.org on 2011/10/06 20:14:47 UTC
svn commit: r1179739 -
/qpid/branches/qpid-3346/qpid/doc/book/src/Using-message-groups.xml
Author: kgiusti
Date: Thu Oct 6 18:14:47 2011
New Revision: 1179739
URL: http://svn.apache.org/viewvc?rev=1179739&view=rev
Log:
QPID-3346: minor doc update
Modified:
qpid/branches/qpid-3346/qpid/doc/book/src/Using-message-groups.xml
Modified: qpid/branches/qpid-3346/qpid/doc/book/src/Using-message-groups.xml
URL: http://svn.apache.org/viewvc/qpid/branches/qpid-3346/qpid/doc/book/src/Using-message-groups.xml?rev=1179739&r1=1179738&r2=1179739&view=diff
==============================================================================
--- qpid/branches/qpid-3346/qpid/doc/book/src/Using-message-groups.xml (original)
+++ qpid/branches/qpid-3346/qpid/doc/book/src/Using-message-groups.xml Thu Oct 6 18:14:47 2011
@@ -218,15 +218,40 @@
Message grouping is not supported on LVQ or Priority queues.
</para>
</note>
+ <example>
+ <title>Creating a message group queue via qpid-config</title>
+ <para>
+ This example uses the qpid-config tool to create a message group queue called
+ "MyMsgQueue". The message header that contains the group identifier will use
+ the key "GROUP_KEY".
+ </para>
+ <programlisting>
+ qpid-config add queue MyMsgQueue --group-header="GROUP_KEY" --shared-groups"
+ </programlisting>
+ </example>
+ <example>
+ <title>Creating a message group queue using address syntax (C++)</title>
+ <para>
+ This example uses the messaging address syntax to create a message group queue
+ with the same configuration as the previous example.
+ </para>
+ <programlisting>
+ sender = session.createSender("MyMsgQueue; {create:always, delete:receiver, node: {x-declare: {arguments:"
+ " {'qpid.group_header_key':'GROUP_KEY', 'qpid.shared_msg_group':1}}}}")
+ </programlisting>
+ </example>
<section role="h3" id="usingmessagegroups-DefaultGroup">
<title>
Default Group
</title>
<para>
Should a message without a group identifier arrive at a queue configured for message grouping, the broker assigns the message to the default group. Therefore, all such "unidentified" messages are considered by the broker as part of the same group. The name of the default group is <command>"qpid.no-group"</command>. This default can be overridden by suppling a different value to the broker configuration item <command>"default-message-group"</command>:
- <programlisting>
- qpidd --default-msg-group "EMPTY-GROUP"
- </programlisting>
+ <example>
+ <title>Overriding the default message group identifier for the broker</title>
+ <programlisting>
+ qpidd --default-msg-group "EMPTY-GROUP"
+ </programlisting>
+ </example>
</para>
</section>
</section>
---------------------------------------------------------------------
Apache Qpid - AMQP Messaging Implementation
Project: http://qpid.apache.org
Use/Interact: mailto:commits-subscribe@qpid.apache.org