it might be also valuable to point out how default values are determined, if they are not set explicitly on queue creation.

eg
i'll set 
flow-stop-size=200 ( so stop-size < default-stop-size )
what value is flow-resume-size?

if i set following values, at the end resume-size will not be the value i've set 
flow-stop-size=200
flow-resume-size=0

flow-stop-size=0
flow-resume-size=200

See the upstream documentation for details about this feature:

http://qpid.apache.org/books/0.10/AMQP-Messaging-Broker-CPP-Book/html/ch01s09.html

Thanks Ken, that's a better source than what I'd been able to find upstream. Working on this today (Thursday May 12).

This looks great!

I did find one problem - appears to originate with the original upstream text - see 3 corrections below in []'s:



Queue Threshold Example
Consider a queue with a maximum limit of 1000 on the total number of messages that may be enqueued to that queue. If a user configures flow-stop-threshold [SHOULD BE "flow_stop_count"] with the value 900, and flow_resume_threshold [SHOULD BE "flow_resume_count"] with the value 500. With these thresholds the following queue activity occurs:

    *
      When the total number of enqueued messages is greater than [SHOULD BE "less than"] or equal to 900, the queue's flow control state is OFF.
    *
      When the total number of enqueued messages is greater than 900, the queue's flow control state transitions to ON.
    *
      When the queue's flow control state is "ON", it remains "ON" until the total number of enqueued messages is less than 500. At that point, the queue's flow control state transitions to "OFF".

Thanks Ken, your producer flow control expertise is most appreciated. Will get those fixes in this week.

--> VERIFIED