svn commit: r618213 - /db/derby/docs/trunk/src/tools/rtoolsijpropref38481.dita

[dy...@apache.org]

Author: dyre
Date: Mon Feb  4 01:15:52 2008
New Revision: 618213

URL: http://svn.apache.org/viewvc?rev=618213&view=rev
Log:
DERBY-2683: tools and utilities guide: ij.URLCheck's list of checked attributes is not correct
Patch contributed by Kim Haase
Patch file: DERBY-2683.diff

Modified:
    db/derby/docs/trunk/src/tools/rtoolsijpropref38481.dita

Modified: db/derby/docs/trunk/src/tools/rtoolsijpropref38481.dita
URL: http://svn.apache.org/viewvc/db/derby/docs/trunk/src/tools/rtoolsijpropref38481.dita?rev=618213&r1=618212&r2=618213&view=diff
==============================================================================
--- db/derby/docs/trunk/src/tools/rtoolsijpropref38481.dita (original)
+++ db/derby/docs/trunk/src/tools/rtoolsijpropref38481.dita Mon Feb  4 01:15:52 2008
@@ -25,17 +25,17 @@
 </prolog><refbody>
 <section><title>Function</title>
 <p>This property determines whether <codeph>ij</codeph> checks for invalid or non-<ph conref="../conrefs.dita#prod/productshortname"></ph> URL
-attributes. Set this property to <i>false</i> to prevent <codeph>ij</codeph> from validating URL attributes. The default value is <i>true</i>.</p>
+attributes when you are using the embedded driver. Set this property to <i>false</i> to prevent <codeph>ij</codeph> from validating URL attributes. The default value is <i>true</i>.</p>
 <p>When the <i>ij.URLCheck</i> property is set to <i>true</i>, you are notified whenever a connection URL contains an incorrectly
 specified attribute. For example if the attribute name is misspelled or cased
 incorrectly <codeph>ij</codeph> prints a message.  
 <note><codeph>ij</codeph> checks
 attribute <i>values</i> if the attribute has pre-defined
-values. For example, the attribute <i>unicode</i> has the
-pre-defined values of <i>true</i> or <i>false</i>. If you try to set the attribute unicode to a value other than
-true or false, <codeph>ij</codeph> displays an error. For example:  
-<codeblock>ij&gt; <b>Connect 'jdbc:derby:anyDB;create=true;unicode=falj';</b>
-ERROR XJ05B: JDBC attribute 'unicode' has an invalid value 'falj',
+values. For example, the attribute <i>shutdown</i> has the
+pre-defined values of <i>true</i> or <i>false</i>. If you try to set the attribute <i>shutdown</i> to a value other than
+<i>true</i> or <i>false</i>, <codeph>ij</codeph> displays an error. For example:  
+<codeblock>ij&gt; <b>Connect 'jdbc:derby:anyDB;shutdown=rue';</b>
+ERROR XJ05B: JDBC attribute 'shutdown' has an invalid value 'rue',
 valid values are '{true|false}'.
 ij&gt;</codeblock></note></p>
 </section>
@@ -48,7 +48,7 @@
 ij version <ph conref="../conrefs.dita#vers/shortversionnumber"></ph> 
 ij&gt; <b>connect 'mydb;uSer=naomi';</b>
 URL Attribute [uSer=naomi]
-   Case of the <ph conref="../conrefs.dita#prod/productshortname"></ph>  attribute is incorrect.</codeblock></p>
+   Case of the <ph conref="../conrefs.dita#prod/productshortname"></ph> attribute is incorrect.</codeblock></p>
 <p>The following command line specifies to turn off URL attribute checking
 in <codeph>ij</codeph>.   
 <codeblock><b>java -Dij.URLCheck=false org.apache.derby.tools.ij</b>
@@ -59,21 +59,10 @@
 using <codeph>ij</codeph> with a non-<ph conref="../conrefs.dita#prod/productshortname"></ph> JDBC driver or database.</p>
 </example>
 <section><title>Notes</title>
-<p>URLCheck does not check the validity of properties, only database connection URL <i>attributes</i>.</p>
-<p><codeph>ij</codeph> recognizes the following attributes:  
-<ul>
-<li><i>bootPassword</i></li>
-<li><i>create</i></li>
-<li><i>databaseName</i></li>
-<li><i>dataEncryption</i></li>
-<li><i>encryptionAlgorithm</i></li>
-<li><i>encryptionProvider</i></li>
-<li><i>territory</i></li>
-<li><i>logDevice</i></li>
-<li><i>password</i></li>
-<li><i>shutdown</i></li>
-<li><i>unicode</i></li>
-<li><i>upgrade</i></li>
-<li><i>user</i></li>
-</ul></p>
+<p>The URL checker does not check the validity of properties, only database connection URL <i>attributes</i>.</p>
+<p>For a list of attributes, see "Setting attributes for the database
+connection URL" in the <ph conref="../conrefs.dita#pub/citref"></ph>. Because
+the <i>ij.URLCheck</i> property is valid only with the embedded driver, it does
+not apply to attributes such as <i>securityMechanism=value</i>,
+<i>ssl=sslMode</i>, and the attributes related to tracing.</p>
 </section></refbody></reference>