docs@glassfish.java.net

asadmin documentation error

From: Daniel Pallett <daniel.pallett_at_yahoo.com>
Date: Thu, 3 May 2012 14:45:02 +0100 (BST)

Hi,
 
I’d like to report an error with your documentation.
 
The glassfish asadmin command “create-jmsdest” has erroneous
documentation for the properties – the cases of the first characters are wrong.
 
The documentation for asadmin (link below) lists an example
property as “useDMQ”
http://docs.oracle.com/cd/E26576_01/doc.312/e24938/create-jmsdest.htm
 
However, this is wrong, and for it to actually take effect
you must use “UseDMQ”. The properties seem to be cased as per this
documentation
http://docs.oracle.com/cd/E19316-01/820-6766/gcamj/index.html
 
However if you go through “imqcmd create/update dst” then
the lower case “useDMQ” is correct, as the documentation lists.
                http://docs.oracle.com/cd/E26576_01/doc.312/e24943/physical-destination-properties.htm
 
Other people who seem to also have had this issue - http://www.java.net/forum/topic/glassfish/glassfish/how-set-properties-jms-destination
 
Further, when viewing the JMS Physical Destination in the
glassfish web admin page it doesn’t correctly reflect the status of the “Use
Dead Message Queue” property, as it is always true (you can change the property
correctly, but the web page will always show true regardless of the actual
value).
 
The following was on Windows XP SP3 with Glassfish version
3.1.2 and “Server Message Queue 4.5.2”.
 
Please also note the email address ( glassfish-docs_us_at_oracle.com )
given on the contact us page ( http://docs.oracle.com/cd/E26576_01/dcommon/html/feedback.htm ) is wrong - the email got bounced ("Internal Lists are not available from the Internet").
 
Regards,
Daniel Pallett