)]}'
{"doc/source/AMQP1.0.rst":[{"author":{"_account_id":8770,"name":"Ken Giusti","email":"kgiusti@gmail.com","username":"kgiusti"},"change_message_id":"9e64376a0339d6bc724a3039ffacb91d47838e69","unresolved":false,"context_lines":[{"line_number":97,"context_line":"-----------------------"},{"line_number":98,"context_line":""},{"line_number":99,"context_line":"A primary functional difference between a router and a"},{"line_number":100,"context_line":"broker intermediary type is when message acknowledgement occurs. The"},{"line_number":101,"context_line":"router does not \"store\" the message hence message acknowledgement is"},{"line_number":102,"context_line":"performed directly between the messaging peers. In contrast, a"},{"line_number":103,"context_line":"broker stores then forwards the message so that message acknowledgement is"}],"source_content_type":"text/x-rst","patch_set":1,"id":"fa7ab95a_18fa7675","line":100,"updated":"2016-08-29 20:18:53.000000000","message":"Newline after occurs.","commit_id":"e8570cdf98d4404c640b056518de44d8f4c09ccf"},{"author":{"_account_id":8770,"name":"Ken Giusti","email":"kgiusti@gmail.com","username":"kgiusti"},"change_message_id":"9e64376a0339d6bc724a3039ffacb91d47838e69","unresolved":false,"context_lines":[{"line_number":99,"context_line":"A primary functional difference between a router and a"},{"line_number":100,"context_line":"broker intermediary type is when message acknowledgement occurs. The"},{"line_number":101,"context_line":"router does not \"store\" the message hence message acknowledgement is"},{"line_number":102,"context_line":"performed directly between the messaging peers. In contrast, a"},{"line_number":103,"context_line":"broker stores then forwards the message so that message acknowledgement is"},{"line_number":104,"context_line":"performed in two stages. In the first stage, a message"},{"line_number":105,"context_line":"acknowledgement occurs between the Sender and the broker. In the"}],"source_content_type":"text/x-rst","patch_set":1,"id":"fa7ab95a_814031a7","line":102,"updated":"2016-08-29 20:18:53.000000000","message":"how about \n\n\"... hence it does not generate an acknowledgement.  Instead the consuming endpoint is responsible for acknowledgement and the router forwards that acknowledgement back to the sender.  This is known as \u0027end-to-end\u0027 acknowledgement.","commit_id":"e8570cdf98d4404c640b056518de44d8f4c09ccf"},{"author":{"_account_id":8770,"name":"Ken Giusti","email":"kgiusti@gmail.com","username":"kgiusti"},"change_message_id":"9e64376a0339d6bc724a3039ffacb91d47838e69","unresolved":false,"context_lines":[{"line_number":104,"context_line":"performed in two stages. In the first stage, a message"},{"line_number":105,"context_line":"acknowledgement occurs between the Sender and the broker. In the"},{"line_number":106,"context_line":"second stage, an acknowledgement occurs between the broker and"},{"line_number":107,"context_line":"the Server. This difference affects how long the Sender pends"},{"line_number":108,"context_line":"subsequent processing."},{"line_number":109,"context_line":""},{"line_number":110,"context_line":"::"}],"source_content_type":"text/x-rst","patch_set":1,"id":"fa7ab95a_4145496e","line":107,"updated":"2016-08-29 20:18:53.000000000","message":"Add a newline after \"the Server.\"","commit_id":"e8570cdf98d4404c640b056518de44d8f4c09ccf"},{"author":{"_account_id":8770,"name":"Ken Giusti","email":"kgiusti@gmail.com","username":"kgiusti"},"change_message_id":"9e64376a0339d6bc724a3039ffacb91d47838e69","unresolved":false,"context_lines":[{"line_number":105,"context_line":"acknowledgement occurs between the Sender and the broker. In the"},{"line_number":106,"context_line":"second stage, an acknowledgement occurs between the broker and"},{"line_number":107,"context_line":"the Server. This difference affects how long the Sender pends"},{"line_number":108,"context_line":"subsequent processing."},{"line_number":109,"context_line":""},{"line_number":110,"context_line":"::"},{"line_number":111,"context_line":""}],"source_content_type":"text/x-rst","patch_set":1,"id":"fa7ab95a_c159595c","line":108,"updated":"2016-08-29 20:18:53.000000000","message":"\"subsequent processing\" is a bit vague to me.  How about\n\nwaiting for the message transfer to complete.","commit_id":"e8570cdf98d4404c640b056518de44d8f4c09ccf"},{"author":{"_account_id":8770,"name":"Ken Giusti","email":"kgiusti@gmail.com","username":"kgiusti"},"change_message_id":"9e64376a0339d6bc724a3039ffacb91d47838e69","unresolved":false,"context_lines":[{"line_number":128,"context_line":"4. The Server indicates the acknowledgement via the router"},{"line_number":129,"context_line":"5. The router forwards the acknowledgement to the Sender"},{"line_number":130,"context_line":""},{"line_number":131,"context_line":"In this sequence, the Sender pends until (5)."},{"line_number":132,"context_line":""},{"line_number":133,"context_line":"::"},{"line_number":134,"context_line":""}],"source_content_type":"text/x-rst","patch_set":1,"id":"fa7ab95a_c456c7d1","line":131,"updated":"2016-08-29 20:18:53.000000000","message":"sequence, a Sender pending for acknowledgement until step (5) occurs.","commit_id":"e8570cdf98d4404c640b056518de44d8f4c09ccf"},{"author":{"_account_id":8770,"name":"Ken Giusti","email":"kgiusti@gmail.com","username":"kgiusti"},"change_message_id":"9e64376a0339d6bc724a3039ffacb91d47838e69","unresolved":false,"context_lines":[{"line_number":152,"context_line":"5. The Server indicates the acknowledgement to the broker"},{"line_number":153,"context_line":""},{"line_number":154,"context_line":"In this sequence, the Sender pends until (2)."},{"line_number":155,"context_line":""},{"line_number":156,"context_line":"Batched Notifications **Note Well**"},{"line_number":157,"context_line":"^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^"},{"line_number":158,"context_line":""}],"source_content_type":"text/x-rst","patch_set":1,"id":"fa7ab95a_649dfb58","line":155,"updated":"2016-08-29 20:18:53.000000000","message":"Add an closing paragraph to be explicit about the conclusion:\n\nTherefore the broker-based Sender receives the acknowledgement earlier in the transfer than the routed case.  However in the brokered case receipt of the acknowledgement does not imply that the message has been (or will ever be) received by the Server.","commit_id":"e8570cdf98d4404c640b056518de44d8f4c09ccf"},{"author":{"_account_id":8770,"name":"Ken Giusti","email":"kgiusti@gmail.com","username":"kgiusti"},"change_message_id":"9e64376a0339d6bc724a3039ffacb91d47838e69","unresolved":false,"context_lines":[{"line_number":157,"context_line":"^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^"},{"line_number":158,"context_line":""},{"line_number":159,"context_line":"While the use of a router intermediary for oslo.messaging Notification is"},{"line_number":160,"context_line":"generally not recommended, it should be noted that the use of a router"},{"line_number":161,"context_line":"intermediary with batched notifications may exacerbate the pending"},{"line_number":162,"context_line":"delay for a sender. For example, when a batched notification"},{"line_number":163,"context_line":"configuration is used where batch size is set to 100, the"}],"source_content_type":"text/x-rst","patch_set":1,"id":"fa7ab95a_6b2f2a88","line":160,"updated":"2016-08-29 20:18:53.000000000","message":"replace \"generally\" with \u0027currently\u0027","commit_id":"e8570cdf98d4404c640b056518de44d8f4c09ccf"},{"author":{"_account_id":8770,"name":"Ken Giusti","email":"kgiusti@gmail.com","username":"kgiusti"},"change_message_id":"9e64376a0339d6bc724a3039ffacb91d47838e69","unresolved":false,"context_lines":[{"line_number":159,"context_line":"While the use of a router intermediary for oslo.messaging Notification is"},{"line_number":160,"context_line":"generally not recommended, it should be noted that the use of a router"},{"line_number":161,"context_line":"intermediary with batched notifications may exacerbate the pending"},{"line_number":162,"context_line":"delay for a sender. For example, when a batched notification"},{"line_number":163,"context_line":"configuration is used where batch size is set to 100, the"},{"line_number":164,"context_line":"Server will wait to receive 100 notification messages (or timeout"},{"line_number":165,"context_line":"occurs) before dispatching the notifications to the application. Thus,"}],"source_content_type":"text/x-rst","patch_set":1,"id":"fa7ab95a_2b67e2e9","line":162,"updated":"2016-08-29 20:18:53.000000000","message":"Newline after sender.","commit_id":"e8570cdf98d4404c640b056518de44d8f4c09ccf"},{"author":{"_account_id":8770,"name":"Ken Giusti","email":"kgiusti@gmail.com","username":"kgiusti"},"change_message_id":"9e64376a0339d6bc724a3039ffacb91d47838e69","unresolved":false,"context_lines":[{"line_number":161,"context_line":"intermediary with batched notifications may exacerbate the pending"},{"line_number":162,"context_line":"delay for a sender. For example, when a batched notification"},{"line_number":163,"context_line":"configuration is used where batch size is set to 100, the"},{"line_number":164,"context_line":"Server will wait to receive 100 notification messages (or timeout"},{"line_number":165,"context_line":"occurs) before dispatching the notifications to the application. Thus,"},{"line_number":166,"context_line":"the time the sender pends waiting for an acknowledgement may"},{"line_number":167,"context_line":"significantly increase."}],"source_content_type":"text/x-rst","patch_set":1,"id":"fa7ab95a_4b8ee679","line":164,"updated":"2016-08-29 20:18:53.000000000","message":"Server will wait until 100 notification messages are buffered (or...","commit_id":"e8570cdf98d4404c640b056518de44d8f4c09ccf"},{"author":{"_account_id":8770,"name":"Ken Giusti","email":"kgiusti@gmail.com","username":"kgiusti"},"change_message_id":"9e64376a0339d6bc724a3039ffacb91d47838e69","unresolved":false,"context_lines":[{"line_number":162,"context_line":"delay for a sender. For example, when a batched notification"},{"line_number":163,"context_line":"configuration is used where batch size is set to 100, the"},{"line_number":164,"context_line":"Server will wait to receive 100 notification messages (or timeout"},{"line_number":165,"context_line":"occurs) before dispatching the notifications to the application. Thus,"},{"line_number":166,"context_line":"the time the sender pends waiting for an acknowledgement may"},{"line_number":167,"context_line":"significantly increase."},{"line_number":168,"context_line":""}],"source_content_type":"text/x-rst","patch_set":1,"id":"fa7ab95a_0bd05e1e","line":165,"updated":"2016-08-29 20:18:53.000000000","message":"before the messages are acknowledged.  Since each notifier client can have at most one message outstanding (e.g. pending acknowledgement), then if the total number of notifying clients are less than 100 the batch limit will never be met.  This will effectively pause all notifying clients until the batch timeout expires.\n\n(remove the following two lines)","commit_id":"e8570cdf98d4404c640b056518de44d8f4c09ccf"}]}
