svn commit: r191572 - in /incubator/derby/docs/trunk/src/adminguide: cadminappsclientdiffs.dita cadminappsisolationlev.dita derbyadmin.ditamap

[jt...@apache.org]

Author: jta
Date: Mon Jun 20 14:55:39 2005
New Revision: 191572

URL: http://svn.apache.org/viewcvs?rev=191572&view=rev
Log:
DERBY-371 Applied Jeff Levitt's patch that documents known client/embedded 
differences for the Version 10.1 release

Added:
    incubator/derby/docs/trunk/src/adminguide/cadminappsclientdiffs.dita
Modified:
    incubator/derby/docs/trunk/src/adminguide/cadminappsisolationlev.dita
    incubator/derby/docs/trunk/src/adminguide/derbyadmin.ditamap

Added: incubator/derby/docs/trunk/src/adminguide/cadminappsclientdiffs.dita
URL: http://svn.apache.org/viewcvs/incubator/derby/docs/trunk/src/adminguide/cadminappsclientdiffs.dita?rev=191572&view=auto
==============================================================================
--- incubator/derby/docs/trunk/src/adminguide/cadminappsclientdiffs.dita (added)
+++ incubator/derby/docs/trunk/src/adminguide/cadminappsclientdiffs.dita Mon Jun 20 14:55:39 2005
@@ -0,0 +1,47 @@
+<?xml version="1.0" encoding="utf-8"?>
+<!DOCTYPE concept PUBLIC "-//IBM//DTD DITA Concept//EN"
+ "../dtd/concept.dtd">
+<!-- 
+Copyright 1997, 2004 The Apache Software Foundation or its licensors, as applicable.  
+
+Licensed under the Apache License, Version 2.0 (the "License");  
+you may not use this file except in compliance with the License.  
+You may obtain a copy of the License at      
+
+   http://www.apache.org/licenses/LICENSE-2.0  
+
+Unless required by applicable law or agreed to in writing, software  
+distributed under the License is distributed on an "AS IS" BASIS,  
+WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.  
+See the License for the specific language governing permissions and  
+limitations under the License.
+-->
+<concept id="cadminappsclientdiffs" xml:lang="en-us">
+<title>Differences between the embedded client and the network client driver</title>
+<prolog><metadata>
+<keywords><indexterm>Network client driver<indexterm>differences with embedded
+driver</indexterm></indexterm></keywords>
+</metadata></prolog>
+<conbody>
+<p>The following are known differences that exist between the <ph conref="adminconrefs.dita#prod/productshortname"></ph> embedded
+driver and the network client driver. Note that there may be undocumented
+differences that have not yet been identified. Some differences with the network
+client may be changed in future releases to match the embedded driver functionality.<ul>
+<li>Error messages and SQLStates can differ between the network client and
+embedded driver. Some SQLStates may be null when using the network client,
+particularly for data conversion errors.</li>
+<li>Multiple SQL exceptions and warnings will only return the SQLState of
+the first exception when using the network client. The text of the additional
+exceptions will be appended to the text of the first exception. See <xref
+href="radminapps811974.dita#radminapps811974"></xref>.</li>
+<li>There are no localized error messages for the network client.</li>
+<li>The network client driver fully materializes LOBS when retrieving a row.</li>
+<li>Scrollable cursors (<codeph>ResultSet.TYPE_SCROLL_SENSITIVE</codeph> or <codeph>ResultSet.TYPE_SCROLL_INSENSITIVE</codeph>)
+are not supported using the network client if the result set contains LOB
+data. <codeph>TYPE_FORWARD_ONLY</codeph> must be specified for result sets
+containing LOB data.</li>
+<li>To use an encrypted user id and password, you need to have the IBM's Java
+Cryptography Extension (JCE) Version 1.2.1 or later.</li>
+</ul></p>
+</conbody>
+</concept>

Modified: incubator/derby/docs/trunk/src/adminguide/cadminappsisolationlev.dita
URL: http://svn.apache.org/viewcvs/incubator/derby/docs/trunk/src/adminguide/cadminappsisolationlev.dita?rev=191572&r1=191571&r2=191572&view=diff
==============================================================================
--- incubator/derby/docs/trunk/src/adminguide/cadminappsisolationlev.dita (original)
+++ incubator/derby/docs/trunk/src/adminguide/cadminappsisolationlev.dita Mon Jun 20 14:55:39 2005
@@ -1,32 +0,0 @@
-<?xml version="1.0" encoding="utf-8"?>
-<!-- 
-Copyright 1997, 2004 The Apache Software Foundation or its licensors, as applicable.  
-
-Licensed under the Apache License, Version 2.0 (the "License");  
-you may not use this file except in compliance with the License.  
-You may obtain a copy of the License at      
-
-   http://www.apache.org/licenses/LICENSE-2.0  
-
-Unless required by applicable law or agreed to in writing, software  
-distributed under the License is distributed on an "AS IS" BASIS,  
-WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.  
-See the License for the specific language governing permissions and  
-limitations under the License.
--->
-<!DOCTYPE concept PUBLIC "-//IBM//DTD DITA Concept//EN" "../dtd/concept.dtd">
-<concept xml:lang="en-us" id="cadminappsisolationlev">
-<title>Isolation level</title>
-<prolog>
-</prolog>
-<conbody>
-<p>When you use the <ph conref="adminconrefs.dita#prod/productshortname"></ph> Network Server, the <i>java.sql.Connection.setTransactionIsolation()</i> method behaves somewhat differently than when <ph conref="adminconrefs.dita#prod/productshortname"></ph> runs in embedded
-mode:
-<ol>
-<li><i>setTransactionIsolation()</i> does not commit the
-transaction.</li>
-<li>The new isolation level is applied only to statements created after <i>setTransactionIsolation()</i> is called. Statements created
-with the previous isolation level will continue to be executed with the isolation
-level that was set when they were created.</li>
-</ol></p>
-</conbody></concept>

Modified: incubator/derby/docs/trunk/src/adminguide/derbyadmin.ditamap
URL: http://svn.apache.org/viewcvs/incubator/derby/docs/trunk/src/adminguide/derbyadmin.ditamap?rev=191572&r1=191571&r2=191572&view=diff
==============================================================================
--- incubator/derby/docs/trunk/src/adminguide/derbyadmin.ditamap (original)
+++ incubator/derby/docs/trunk/src/adminguide/derbyadmin.ditamap Mon Jun 20 14:55:39 2005
@@ -109,7 +109,7 @@
 </topicref>
 </topicref>
 <topicref href="cadminapps.dita" navtitle="Differences between running Derby in embedded mode and using the Network Server">
-<topicref href="cadminappsisolationlev.dita" navtitle="Isolation level"></topicref>
+<topicref href="cadminappsclientdiffs.dita" navtitle="Differences between the embedded client and the network client driver"></topicref>
 <topicref href="radminappsresultsetdiffs.dita" navtitle="Updatable Result Sets"></topicref>
 <topicref href="radminapps811974.dita" navtitle="Error messages"></topicref>
 <topicref href="cadminapps49914.dita" navtitle="User authentication">