Red Hat Bugzilla – Bug 860714
reliability parameter incorrectly documented
Last modified: 2015-11-15 20:14:27 EST
Description of problem: The parameter in documentation on this page: https://access.redhat.com/knowledge/docs/en-US/Red_Hat_Enterprise_MRG/2/html/Messaging_Programming_Reference/chap-Reliability_and_Quality_of_Service.html#Reliable_Link States the reliability parameter for reliable is 'reliable' when it should be 'at-least-once'. Version-Release number of selected component (if applicable): How reproducible: 100% Steps to Reproduce: 1. Go to link referenced above 2. read "Specifying a reliable link" section 3. Profit!! Actual results: states 'reliable' is the reliability parameter. Expected results: states 'at-least-once' is the reliability parameter. Additional info:
Update Topic 10274
Changed text to read: ... include link: {'reliability': 'at-least-once'} in the address. For example: sender = session.sender("amq.topic;{link: {'reliability': 'at-least-once'}}") http://documentation-devel.engineering.redhat.com/docs/en-US/Red_Hat_Enterprise_MRG/2/html-single/Messaging_Programming_Reference/index.html#sect-Link_Reliability
Changes done for this defect are ok. There are unfortunately two more references to 'reliable' as option variable (formatted in bold) which need to be adjusted, see below... 1] 8.3. Producer Flow Control/8.3.1. Flow Control Flow control relies on a reliable link between ^^^^^^^^ should be italic or normal instead of bold as 'reliable' is not option value just definition of concept 2] 8.6. Transactions/8.6.1. Transactions Note that transactions require a reliable link to function. ^^^^^^^^ should be italic or normal instead of bold as 'reliable' is not option value just definition of concept -> ASSIGNED
Section 8.3: http://documentation-devel.engineering.redhat.com/docs/en-US/Red_Hat_Enterprise_MRG/2/html-single/Messaging_Programming_Reference/index.html#sect-Producer_Flow_Control Section 8.6: http://documentation-devel.engineering.redhat.com/docs/en-US/Red_Hat_Enterprise_MRG/2/html-single/Messaging_Programming_Reference/index.html#sect-Transactions
All necessary changes were added (incl. comment 3). -> VERIFIED
MRG Messaging 2.2.3 docs have been released as of 14 November 2012, the docs are now available on https://access.redhat.com/knowledge/docs/Red_Hat_Enterprise_MRG/