Bug 1271994 - [Docs] MPR Qpid JMS amqp 1.0 client configuration examples of JNDI properties might be wrong
[Docs] MPR Qpid JMS amqp 1.0 client configuration examples of JNDI properties...
Status: VERIFIED
Product: Red Hat Enterprise MRG
Classification: Red Hat
Component: Messaging_Programming_Reference (Show other bugs)
3.2
Unspecified Unspecified
unspecified Severity medium
: ---
: ---
Assigned To: Scott Mumford
Messaging QE
:
Depends On:
Blocks:
  Show dependency treegraph
 
Reported: 2015-10-15 05:01 EDT by Michal Toth
Modified: 2015-10-16 08:51 EDT (History)
1 user (show)

See Also:
Fixed In Version:
Doc Type: Bug Fix
Doc Text:
Story Points: ---
Clone Of:
Environment:
Build Name: 19948, Messaging Programming Reference-3-3.2.0 Build Date: 15-10-2015 12:05:07 Topic ID: 44875-771734 [Latest]
Last Closed:
Type: Bug
Regression: ---
Mount Type: ---
Documentation: ---
CRM:
Verified Versions:
Category: ---
oVirt Team: ---
RHEL 7.3 requirements from Atomic Host:
Cloudforms Team: ---


Attachments (Terms of Use)

  None (edit)
Description Michal Toth 2015-10-15 05:01:58 EDT
Title: QPID AMQP 1.0 JMS Client Configuration

This Bz is connected to Bug 1271434. Creating this new BZ as stated in Bug 1271434#10
I think there are the following issues in 21.1 part of current MPR.
(Possible errors are listed under a,b,c..)

⁠21.1. QPID AMQP 1.0 JMS Client Configuration
a) How is it with words in bold and following commas? I see there "extra" space, which should not be there. It seems to me, that is just an error of used template, so it is not an error(?) 

b) In the second paragraph "class org.apache.qpid.jms.jndi.JmsInitialContextFactory" - wrong bold text, font issue? missing dot in 'visual mode', but when copy&pasted - dot is there. Could you try using italics for whole class name?

c) 1. Via jndi.properties file on the Java Classpath.
I believe in example in the grey box, there should be an example of JNDI property file, not how to create Context.
For example
java.naming.factory.initial=org.apache.qpid.jms.jndi.JmsInitialContextFactory


d) 2. Via system properties.
-Djava.naming.factory.initial=org.apache.qpid.jms.jndi.JmsInitialContextFactory


e) Just a little bold/not bold text in  ⁠21.2. QPID AMQP 1.0 JMS Client Connection URLs
Why are some bold and some not? 
"Connection, Session, MessageConsumer and MessageProducer." 
- either make Connection/Session also bold or please unbold them all (and ConnectionFactory above


I think that c) and d) are rather questions for Robbie.
Comment 1 Robbie Gemmell 2015-10-15 06:49:13 EDT
The items you reference above as c) and d) are as expected. The section is about how to instantiate the InitialContext in code, which the example code segments show for the three general cases detailed with the surrounding text describing the scenario. They each reference a common overview of the properties [file] format since it applies to them all, avoiding duplicating the details, with a general example of the properties and how the context might be used then given.
Comment 4 Michal Toth 2015-10-16 08:51:15 EDT
Thank you for your anwsers. 
Checked the fixes and marking as verified.

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