Bugzilla will be upgraded to version 5.0 on a still to be determined date in the near future. The original upgrade date has been delayed.
Bug 614551 - Addressing grammar and examples incomplete
Addressing grammar and examples incomplete
Product: Red Hat Enterprise MRG
Classification: Red Hat
Component: Messaging_Programming_Reference (Show other bugs)
All Linux
low Severity medium
: 2.0
: ---
Assigned To: Alison Young
: Documentation
Depends On: 652506
  Show dependency treegraph
Reported: 2010-07-14 14:22 EDT by William Henry
Modified: 2012-09-21 08:58 EDT (History)
2 users (show)

See Also:
Fixed In Version:
Doc Type: Bug Fix
Doc Text:
Story Points: ---
Clone Of:
Last Closed: 2011-02-02 18:56:15 EST
Type: ---
Regression: ---
Mount Type: ---
Documentation: ---
Verified Versions:
Category: ---
oVirt Team: ---
RHEL 7.3 requirements from Atomic Host:
Cloudforms Team: ---

Attachments (Terms of Use)

  None (edit)
Description William Henry 2010-07-14 14:22:35 EDT
Description of problem:

Looking through the addressing section of the User Guide I notice that the grammar doesn't go down into the options deep enough.  From the grammar you can't figure out what a binding looks like or how to declare (x-declare) last value queues etc. 

The document should expand the grammar all the way down to these options.

I'd also suggest providing a few examples of defining different types of queues. e.g. the LVQ.

my-lvq-name; {create: always, node: {x-declare: { 'qpid.last_value_queue':1 }}}

Perhaps combine this with some bindings and a custom exchange.

Version-Release number of selected component (if applicable):

How reproducible:

Steps to Reproduce:
Actual results:

Expected results:

Additional info:
Comment 1 Lana Brindley 2010-07-15 22:26:53 EDT
Please provide further information (what detail you want in the options, examples, etc) for the changes you require.

This will be addressed in the next version of the document.

Comment 2 Lana Brindley 2010-07-18 19:53:03 EDT
Apologies, I had this mixed in with my Grid bugs. Reassigned to Jonathan Robie for completion.

Comment 3 Jonathan Robie 2010-08-30 10:54:43 EDT
I think you're asking for documentation of all AMQP 0-10 specific values in the description of x-declare and x-bindings in Programming in Apache Qpid, and perhaps examples showing how to create various kinds of queues and bindings.

The "x-" is designed as an extension mechanism, and the values allowed within these are not constrained by the grammar. They will also be different for an AMQP 1.0 broker than for an AMQP 0-10 broker.

The messaging API is not really designed as a management API, that's what the QMF API is for. If this can be done externally to the program, qpid-config or the management console can be used for this. In the Programming book, we use qpid-config for configuration.
Comment 4 Jonathan Robie 2010-08-30 10:57:00 EDT
I think the User's Guide is the right place to describe how to declare Last Value Queues and Ring Queues. There's a description there now, it should be updated based on the new API.
Comment 5 William Henry 2010-11-04 19:13:41 EDT
Where is that?  I found this for LVQ:

"To use this feature, add a qpid.last_value_queue or qpid.last_value_queue_no_browse key to the arguments of queue declare. The value of the key is user-selected and used only for key matching. Messages published to the queue then need to specify a value for the qpid.LVQ_key in the headers of messages they publish. "

But it mentions queue declare which is the old API.  ???
Comment 6 Lana Brindley 2010-12-12 17:26:53 EST
Please provide further information (what detail you want in the options, examples, etc) for the changes you require.

This will be addressed in version 2.0 of the document, provided information is received in time.

Comment 7 Lana Brindley 2011-02-02 18:56:15 EST
Closing this bug to get it off the MRG docs radar. Please open a new bug when
source documentation is available.


Note You need to log in before you can comment on or make changes to this bug.