You are viewing a plain text version of this content. The canonical link for it is here.
Posted to derby-commits@db.apache.org by jt...@apache.org on 2005/03/31 02:27:28 UTC
svn commit: r159548 [3/17] - in incubator/derby/docs/trunk/src: adminguide/
devguide/ getstart/ tuning/
Modified: incubator/derby/docs/trunk/src/adminguide/tadminovclirun.dita
URL: http://svn.apache.org/viewcvs/incubator/derby/docs/trunk/src/adminguide/tadminovclirun.dita?view=diff&r1=159547&r2=159548
==============================================================================
--- incubator/derby/docs/trunk/src/adminguide/tadminovclirun.dita (original)
+++ incubator/derby/docs/trunk/src/adminguide/tadminovclirun.dita Wed Mar 30 16:26:36 2005
@@ -1,60 +1,60 @@
-<?xml version="1.0" encoding="utf-8"?>
-
-<!DOCTYPE task PUBLIC "-//IBM//DTD DITA Task//EN"
- "../dtd/task.dtd">
-<?Pub Inc?>
-<!--
-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.
--->
-<task id="tadminovclirun" xml:lang="en-us">
-<title>Running the SimpleNetworkClientSample program</title>
-<taskbody>
-<context> <p>To connect to the Network Server that has been started as part
-of the SimpleNetworkServerSample program: </p><?Pub Caret1?></context>
-<steps>
-<step><cmd>Open a command prompt and change directories to the <codeph>%<ph
-conref="adminconrefs.dita#prod/productinstallpath"></ph>%\demo\programs\nserverdemo</codeph> directory,
-where <codeph>%<ph conref="adminconrefs.dita#prod/productinstallpath"></ph>%</codeph> is
-the directory where you installed <ph conref="adminconrefs.dita#prod/productshortname"></ph>.</cmd>
-</step>
-<step><cmd>Network Server clients need only the following jar files in the
-CLASSPATH to connect to the Network Server. Set the CLASSPATH to include the
-following jar files: </cmd>
-<substeps>
-<substep><cmd>The current directory (".")</cmd></substep>
-<substep><cmd>db2jcc.jar</cmd><info>This jar file must be in your CLASSPATH
-to use the DB2 JDBC Universal Driver.</info></substep>
-<substep><cmd>db2jcc_license_c.jar</cmd><info>This jar file is the license
-file for the Universal Driver for <ph conref="adminconrefs.dita#prod/productshortname"></ph>.</info>
-</substep>
-</substeps>
-</step>
-<step><cmd>After you have set up your environment correctly, execute the application
-from the same directory: </cmd><stepxmp><codeblock>java SimpleNetworkClientSample</codeblock></stepxmp>
-<stepresult>You should receive output similar to the following if the program
-runs successfully: <codeblock>Starting Sample client program
-Got a client connection via the DriverManager.
-connection from datasource; getDriverName =
- IBM DB2 JDBC Universal Driver Architecture
-Got a client connection via a DataSource.
-Testing the connection obtained via DriverManager by executing a sample query
-number of rows in sys.systables = 16
-Testing the connection obtained via a DataSource by executing a sample query
-number of rows in sys.systables = 16
-Goodbye!</codeblock></stepresult></step>
-</steps>
-</taskbody>
-</task>
-<?Pub *0000002864?>
+<?xml version="1.0" encoding="utf-8"?>
+
+<!DOCTYPE task PUBLIC "-//IBM//DTD DITA Task//EN"
+ "../dtd/task.dtd">
+<?Pub Inc?>
+<!--
+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.
+-->
+<task id="tadminovclirun" xml:lang="en-us">
+<title>Running the SimpleNetworkClientSample program</title>
+<taskbody>
+<context> <p>To connect to the Network Server that has been started as part
+of the SimpleNetworkServerSample program: </p><?Pub Caret1?></context>
+<steps>
+<step><cmd>Open a command prompt and change directories to the <codeph>%<ph
+conref="adminconrefs.dita#prod/productinstallpath"></ph>%\demo\programs\nserverdemo</codeph> directory,
+where <codeph>%<ph conref="adminconrefs.dita#prod/productinstallpath"></ph>%</codeph> is
+the directory where you installed <ph conref="adminconrefs.dita#prod/productshortname"></ph>.</cmd>
+</step>
+<step><cmd>Network Server clients need only the following jar files in the
+CLASSPATH to connect to the Network Server. Set the CLASSPATH to include the
+following jar files: </cmd>
+<substeps>
+<substep><cmd>The current directory (".")</cmd></substep>
+<substep><cmd>db2jcc.jar</cmd><info>This jar file must be in your CLASSPATH
+to use the DB2 JDBC Universal Driver.</info></substep>
+<substep><cmd>db2jcc_license_c.jar</cmd><info>This jar file is the license
+file for the Universal Driver for <ph conref="adminconrefs.dita#prod/productshortname"></ph>.</info>
+</substep>
+</substeps>
+</step>
+<step><cmd>After you have set up your environment correctly, execute the application
+from the same directory: </cmd><stepxmp><codeblock>java SimpleNetworkClientSample</codeblock></stepxmp>
+<stepresult>You should receive output similar to the following if the program
+runs successfully: <codeblock>Starting Sample client program
+Got a client connection via the DriverManager.
+connection from datasource; getDriverName =
+ IBM DB2 JDBC Universal Driver Architecture
+Got a client connection via a DataSource.
+Testing the connection obtained via DriverManager by executing a sample query
+number of rows in sys.systables = 16
+Testing the connection obtained via a DataSource by executing a sample query
+number of rows in sys.systables = 16
+Goodbye!</codeblock></stepresult></step>
+</steps>
+</taskbody>
+</task>
+<?Pub *0000002864?>
Propchange: incubator/derby/docs/trunk/src/adminguide/tadminovclirun.dita
------------------------------------------------------------------------------
svn:eol-style = native
Modified: incubator/derby/docs/trunk/src/adminguide/tadminovnsrundemo.dita
URL: http://svn.apache.org/viewcvs/incubator/derby/docs/trunk/src/adminguide/tadminovnsrundemo.dita?view=diff&r1=159547&r2=159548
==============================================================================
--- incubator/derby/docs/trunk/src/adminguide/tadminovnsrundemo.dita (original)
+++ incubator/derby/docs/trunk/src/adminguide/tadminovnsrundemo.dita Wed Mar 30 16:26:36 2005
@@ -1,105 +1,105 @@
-<?xml version="1.0" encoding="utf-8"?>
-
-<!DOCTYPE task PUBLIC "-//IBM//DTD DITA Task//EN"
- "../dtd/task.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.
--->
-<task id="tadminovnsrundemo" xml:lang="en-us">
-<title>Running the NsSample sample program</title>
-<taskbody>
-<context> <p>To run the NsSample program: </p> </context>
-<steps>
-<step><cmd>Open a command prompt and change directories to the %<ph conref="adminconrefs.dita#prod/productinstallpath"></ph>%\demo\programs\
-directory, where %<ph conref="adminconrefs.dita#prod/productinstallpath"></ph>%
-is the directory where you installed <ph conref="adminconrefs.dita#prod/productshortname"></ph>.</cmd>
-</step>
-<step><cmd>Set the CLASSPATH to the current directory (".") and also include
-the following jar files in order to use the Network Server and the DB2 JDBC
-Universal Driver:</cmd>
-<substeps>
-<substep><cmd>derbynet.jar</cmd><info><p>The Network Server jar file. It must
-be in your CLASSPATH to use any of the Network Server functions.</p></info>
-</substep>
-<substep><cmd>db2jcc.jar</cmd><info><p>This jar file must be in your CLASSPATH
-to use the DB2 JDBC Universal Driver.</p></info></substep>
-<substep><cmd>db2jcc_license_c.jar</cmd><info><p>This jar file is the license
-file for the Universal Driver.</p></info></substep>
-<substep><cmd>derby.jar</cmd><info><p>The <ph conref="adminconrefs.dita#prod/productshortname"></ph> database
-engine jar file.</p></info></substep>
-</substeps>
-</step>
-<step><cmd>Test the CLASSPATH settings by running the following Java command:</cmd>
-<stepxmp><codeblock> java org.apache.derby.tools.sysinfo</codeblock></stepxmp>
-<stepresult>This command will show the <ph conref="adminconrefs.dita#prod/productshortname"></ph> jar
-files that are in the CLASSPATH as well as the DB2 JDBC Universal Driver along
-with their respective versions.</stepresult></step>
-<step><cmd>After you have set up your environment correctly, execute the application
-from the same directory: </cmd><stepxmp><codeblock>java nserverdemo.NsSample</codeblock></stepxmp>
-<stepresult>You should receive output similar to the following if the program
-runs successfully:<codeblock><ph conref="adminconrefs.dita#prod/productshortname"></ph> Network Server created
-Server is ready to accept connections on port 1621.
-Connection number: 1.
-[NsSample] <ph conref="adminconrefs.dita#prod/productshortname"></ph> Network Server started.
-[NsSample] Sample <ph conref="adminconrefs.dita#prod/productshortname"></ph> Network Server program demo starting.
-Please wait .....................
-Connection number: 2.
-[NsSampleWork] Begin creating table - SAMPLETBL and necessary indexes.
-[NsSampleClientThread] Thread id - 1; started.
-[NsSampleWork] Thread id - 1; requests database connection,
- dbUrl =jdbc:derby:NSSampledb;
-[NsSampleClientThread] Thread id - 2; started.
-[NsSampleWork] Thread id - 2; requests database connection,
- dbUrl =jdbc:derby:net://localhost:1621/
- NSSampledb;create=true:retrieveMessagesFromServerOnGetMessage=true;
- deferPrepares=true;
-Connection number: 3.
-[NsSampleWork] Thread id - 1 selected 1 row [313,Derby36 ,1.7686243E23,9620]
-[NsSampleWork] Thread id - 1 selected 1 row [313,Derby36 ,1.7686243E23,9620]
-[NsSampleWork] Thread id - 1; deleted 1 row with t_key = 9620
-[NsSampleWork] Thread id - 1 selected 1 row [700,Derby34 ,8.7620301E9,9547]
-[NsSampleWork] Thread id - 1 selected 1 row [700,Derby34 ,8.7620301E9,9547]
-[NsSampleWork] Thread id - 2 selected 1 row [700,Derby34 ,8.7620301E9,9547]
-[NsSampleWork] Thread id - 2 selected 1 row [700,Derby34 ,8.7620301E9,9547]
-[NsSampleWork] Thread id - 1; inserted 1 row.
-[NsSampleWork] Thread id - 1 selected 1 row [52,Derby34 ,8.7620301E9,9547]
-[NsSampleWork] Thread id - 2; updated 1 row with t_key = 9547
-[NsSampleWork] Thread id - 1; deleted 1 row with t_key = 9547
-[NsSampleWork] Thread id - 2 selected 1 row [617,Derby31 ,773.83636,9321]
-[NsSampleWork] Thread id - 2 selected 1 row [617,Derby31 ,773.83636,9321]
-[NsSampleWork] Thread id - 2 selected 1 row [617,Derby31 ,773.83636,9321]
-[NsSampleWork] Thread id - 2 selected 1 row [617,Derby31 ,773.83636,9321]
-[NsSampleWork] Thread id - 1; inserted 1 row.
-[NsSampleWork] Thread id - 2; deleted 1 row with t_key = 9321
-[NsSampleWork] Thread id - 1; deleted 1 row with t_key = 8707
-[NsSampleWork] Thread id - 1; closed connection to the database.
-[NsSampleClientThread] Thread id - 1; finished all tasks.
-[NsSampleWork] Thread id - 2; deleted 1 row with t_key = 8490
-[NsSampleWork] Thread id - 2; closed connection to the database.
-[NsSampleClientThread] Thread id - 2; finished all tasks.
-[NsSample] Shutting down Network Server.
-Connection number: 4.
-Shutdown successful.
-</codeblock></stepresult></step>
-</steps>
-<result>Running the <i>NsSample</i> program will also create the following
-new directories and files:<ul>
-<li>NSSampledb <p>This directory makes up the <i>NSSampledb</i> database.</p></li>
-<li>derby.log <p>This log file contains <ph conref="adminconrefs.dita#prod/productshortname"></ph> progress
-and error messages.</p></li>
-</ul></result>
-</taskbody>
-</task>
-<?Pub *0000005749?>
+<?xml version="1.0" encoding="utf-8"?>
+
+<!DOCTYPE task PUBLIC "-//IBM//DTD DITA Task//EN"
+ "../dtd/task.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.
+-->
+<task id="tadminovnsrundemo" xml:lang="en-us">
+<title>Running the NsSample sample program</title>
+<taskbody>
+<context> <p>To run the NsSample program: </p> </context>
+<steps>
+<step><cmd>Open a command prompt and change directories to the %<ph conref="adminconrefs.dita#prod/productinstallpath"></ph>%\demo\programs\
+directory, where %<ph conref="adminconrefs.dita#prod/productinstallpath"></ph>%
+is the directory where you installed <ph conref="adminconrefs.dita#prod/productshortname"></ph>.</cmd>
+</step>
+<step><cmd>Set the CLASSPATH to the current directory (".") and also include
+the following jar files in order to use the Network Server and the DB2 JDBC
+Universal Driver:</cmd>
+<substeps>
+<substep><cmd>derbynet.jar</cmd><info><p>The Network Server jar file. It must
+be in your CLASSPATH to use any of the Network Server functions.</p></info>
+</substep>
+<substep><cmd>db2jcc.jar</cmd><info><p>This jar file must be in your CLASSPATH
+to use the DB2 JDBC Universal Driver.</p></info></substep>
+<substep><cmd>db2jcc_license_c.jar</cmd><info><p>This jar file is the license
+file for the Universal Driver.</p></info></substep>
+<substep><cmd>derby.jar</cmd><info><p>The <ph conref="adminconrefs.dita#prod/productshortname"></ph> database
+engine jar file.</p></info></substep>
+</substeps>
+</step>
+<step><cmd>Test the CLASSPATH settings by running the following Java command:</cmd>
+<stepxmp><codeblock> java org.apache.derby.tools.sysinfo</codeblock></stepxmp>
+<stepresult>This command will show the <ph conref="adminconrefs.dita#prod/productshortname"></ph> jar
+files that are in the CLASSPATH as well as the DB2 JDBC Universal Driver along
+with their respective versions.</stepresult></step>
+<step><cmd>After you have set up your environment correctly, execute the application
+from the same directory: </cmd><stepxmp><codeblock>java nserverdemo.NsSample</codeblock></stepxmp>
+<stepresult>You should receive output similar to the following if the program
+runs successfully:<codeblock><ph conref="adminconrefs.dita#prod/productshortname"></ph> Network Server created
+Server is ready to accept connections on port 1621.
+Connection number: 1.
+[NsSample] <ph conref="adminconrefs.dita#prod/productshortname"></ph> Network Server started.
+[NsSample] Sample <ph conref="adminconrefs.dita#prod/productshortname"></ph> Network Server program demo starting.
+Please wait .....................
+Connection number: 2.
+[NsSampleWork] Begin creating table - SAMPLETBL and necessary indexes.
+[NsSampleClientThread] Thread id - 1; started.
+[NsSampleWork] Thread id - 1; requests database connection,
+ dbUrl =jdbc:derby:NSSampledb;
+[NsSampleClientThread] Thread id - 2; started.
+[NsSampleWork] Thread id - 2; requests database connection,
+ dbUrl =jdbc:derby:net://localhost:1621/
+ NSSampledb;create=true:retrieveMessagesFromServerOnGetMessage=true;
+ deferPrepares=true;
+Connection number: 3.
+[NsSampleWork] Thread id - 1 selected 1 row [313,Derby36 ,1.7686243E23,9620]
+[NsSampleWork] Thread id - 1 selected 1 row [313,Derby36 ,1.7686243E23,9620]
+[NsSampleWork] Thread id - 1; deleted 1 row with t_key = 9620
+[NsSampleWork] Thread id - 1 selected 1 row [700,Derby34 ,8.7620301E9,9547]
+[NsSampleWork] Thread id - 1 selected 1 row [700,Derby34 ,8.7620301E9,9547]
+[NsSampleWork] Thread id - 2 selected 1 row [700,Derby34 ,8.7620301E9,9547]
+[NsSampleWork] Thread id - 2 selected 1 row [700,Derby34 ,8.7620301E9,9547]
+[NsSampleWork] Thread id - 1; inserted 1 row.
+[NsSampleWork] Thread id - 1 selected 1 row [52,Derby34 ,8.7620301E9,9547]
+[NsSampleWork] Thread id - 2; updated 1 row with t_key = 9547
+[NsSampleWork] Thread id - 1; deleted 1 row with t_key = 9547
+[NsSampleWork] Thread id - 2 selected 1 row [617,Derby31 ,773.83636,9321]
+[NsSampleWork] Thread id - 2 selected 1 row [617,Derby31 ,773.83636,9321]
+[NsSampleWork] Thread id - 2 selected 1 row [617,Derby31 ,773.83636,9321]
+[NsSampleWork] Thread id - 2 selected 1 row [617,Derby31 ,773.83636,9321]
+[NsSampleWork] Thread id - 1; inserted 1 row.
+[NsSampleWork] Thread id - 2; deleted 1 row with t_key = 9321
+[NsSampleWork] Thread id - 1; deleted 1 row with t_key = 8707
+[NsSampleWork] Thread id - 1; closed connection to the database.
+[NsSampleClientThread] Thread id - 1; finished all tasks.
+[NsSampleWork] Thread id - 2; deleted 1 row with t_key = 8490
+[NsSampleWork] Thread id - 2; closed connection to the database.
+[NsSampleClientThread] Thread id - 2; finished all tasks.
+[NsSample] Shutting down Network Server.
+Connection number: 4.
+Shutdown successful.
+</codeblock></stepresult></step>
+</steps>
+<result>Running the <i>NsSample</i> program will also create the following
+new directories and files:<ul>
+<li>NSSampledb <p>This directory makes up the <i>NSSampledb</i> database.</p></li>
+<li>derby.log <p>This log file contains <ph conref="adminconrefs.dita#prod/productshortname"></ph> progress
+and error messages.</p></li>
+</ul></result>
+</taskbody>
+</task>
+<?Pub *0000005749?>
Propchange: incubator/derby/docs/trunk/src/adminguide/tadminovnsrundemo.dita
------------------------------------------------------------------------------
svn:eol-style = native
Modified: incubator/derby/docs/trunk/src/adminguide/tadminovrunsrvprgm.dita
URL: http://svn.apache.org/viewcvs/incubator/derby/docs/trunk/src/adminguide/tadminovrunsrvprgm.dita?view=diff&r1=159547&r2=159548
==============================================================================
--- incubator/derby/docs/trunk/src/adminguide/tadminovrunsrvprgm.dita (original)
+++ incubator/derby/docs/trunk/src/adminguide/tadminovrunsrvprgm.dita Wed Mar 30 16:26:36 2005
@@ -1,74 +1,74 @@
-<?xml version="1.0" encoding="utf-8"?>
-
-<!DOCTYPE task PUBLIC "-//IBM//DTD DITA Task//EN"
- "../dtd/task.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.
--->
-<task id="tadminovrunsrvprgm" xml:lang="en-us">
-<title>Running the SimpleNetworkServerSample program</title>
-<taskbody>
-<context> <p>To run the <ph conref="adminconrefs.dita#prod/productshortname"></ph> Network
-Server sample program: </p> </context>
-<steps>
-<step><cmd>Open a command prompt and change directories to the <codeph>%<ph
-conref="adminconrefs.dita#prod/productinstallpath"></ph>%\demo\programs\nserverdemo</codeph> directory,
-where <codeph>%<ph conref="adminconrefs.dita#prod/productinstallpath"></ph>%</codeph> is
-the directory where you installed <ph conref="adminconrefs.dita#prod/productshortname"></ph>.</cmd>
-</step>
-<step><cmd>Set the CLASSPATH to include the current directory (".") and the
-following jar files: </cmd>
-<substeps>
-<substep><cmd>derbynet.jar</cmd><info><p>The Network Server jar file. It must
-be in your CLASSPATH because you start the Network Server in this program. </p></info>
-</substep>
-<substep><cmd>derby.jar</cmd><info><p>The database engine jar file. </p></info>
-</substep>
-</substeps>
-</step>
-<step><cmd>Test the CLASSPATH settings by running the following Java command:
- </cmd><stepxmp><codeblock>java org.apache.derby.tools.sysinfo</codeblock></stepxmp>
-<stepresult>This command displays the <ph conref="adminconrefs.dita#prod/productshortname"></ph> jar
-files that are in the CLASSPATH.</stepresult></step>
-<step><cmd>After you have set up your environment correctly, execute the application
-from the same directory: </cmd><stepxmp><codeblock>java SimpleNetworkServerSample</codeblock></stepxmp>
-<stepresult>You should receive output similar to the following if the program
-runs successfully: <codeblock>Starting Network Server
-Testing if Network Server is up and running!
-<ph conref="adminconrefs.dita#prod/productshortname"></ph> Network Server now running
-Got an embedded connection.
-Testing embedded connection by executing a sample query
-number of rows in sys.systables = 16
-While my app is busy with embedded work, ij might connect like this:
-
- $ java -Dij.user=me -Dij.password=pw -Dij.protocol=
- jdbc:derby:net:\\localhost:1527\ org.apache.derby.tools.ij
- ij> connect 'NSSimpleDB:retrieveMessagesFromServerOnGetMessage=true;';
-Watch that punctuation. Put a ':' before the jcc
-attributes and a ';' after each one (even the last).
-
-
-Clients can continue to connect:
-Press [Enter] to stop Server</codeblock></stepresult></step>
-</steps>
-<result><p>Running the SimpleNetworkServerSample program will
-also create the following new directories and files: <ul>
-<li>NSSimpleDB <p>This directory makes up the NSSimpleDB database.</p></li>
-<li>derby.log <p>This log file contains <ph conref="adminconrefs.dita#prod/productshortname"></ph> progress
-and error messages.</p></li>
-</ul></p></result>
-</taskbody>
-</task>
-<?Pub *0000003609?>
+<?xml version="1.0" encoding="utf-8"?>
+
+<!DOCTYPE task PUBLIC "-//IBM//DTD DITA Task//EN"
+ "../dtd/task.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.
+-->
+<task id="tadminovrunsrvprgm" xml:lang="en-us">
+<title>Running the SimpleNetworkServerSample program</title>
+<taskbody>
+<context> <p>To run the <ph conref="adminconrefs.dita#prod/productshortname"></ph> Network
+Server sample program: </p> </context>
+<steps>
+<step><cmd>Open a command prompt and change directories to the <codeph>%<ph
+conref="adminconrefs.dita#prod/productinstallpath"></ph>%\demo\programs\nserverdemo</codeph> directory,
+where <codeph>%<ph conref="adminconrefs.dita#prod/productinstallpath"></ph>%</codeph> is
+the directory where you installed <ph conref="adminconrefs.dita#prod/productshortname"></ph>.</cmd>
+</step>
+<step><cmd>Set the CLASSPATH to include the current directory (".") and the
+following jar files: </cmd>
+<substeps>
+<substep><cmd>derbynet.jar</cmd><info><p>The Network Server jar file. It must
+be in your CLASSPATH because you start the Network Server in this program. </p></info>
+</substep>
+<substep><cmd>derby.jar</cmd><info><p>The database engine jar file. </p></info>
+</substep>
+</substeps>
+</step>
+<step><cmd>Test the CLASSPATH settings by running the following Java command:
+ </cmd><stepxmp><codeblock>java org.apache.derby.tools.sysinfo</codeblock></stepxmp>
+<stepresult>This command displays the <ph conref="adminconrefs.dita#prod/productshortname"></ph> jar
+files that are in the CLASSPATH.</stepresult></step>
+<step><cmd>After you have set up your environment correctly, execute the application
+from the same directory: </cmd><stepxmp><codeblock>java SimpleNetworkServerSample</codeblock></stepxmp>
+<stepresult>You should receive output similar to the following if the program
+runs successfully: <codeblock>Starting Network Server
+Testing if Network Server is up and running!
+<ph conref="adminconrefs.dita#prod/productshortname"></ph> Network Server now running
+Got an embedded connection.
+Testing embedded connection by executing a sample query
+number of rows in sys.systables = 16
+While my app is busy with embedded work, ij might connect like this:
+
+ $ java -Dij.user=me -Dij.password=pw -Dij.protocol=
+ jdbc:derby:net:\\localhost:1527\ org.apache.derby.tools.ij
+ ij> connect 'NSSimpleDB:retrieveMessagesFromServerOnGetMessage=true;';
+Watch that punctuation. Put a ':' before the jcc
+attributes and a ';' after each one (even the last).
+
+
+Clients can continue to connect:
+Press [Enter] to stop Server</codeblock></stepresult></step>
+</steps>
+<result><p>Running the SimpleNetworkServerSample program will
+also create the following new directories and files: <ul>
+<li>NSSimpleDB <p>This directory makes up the NSSimpleDB database.</p></li>
+<li>derby.log <p>This log file contains <ph conref="adminconrefs.dita#prod/productshortname"></ph> progress
+and error messages.</p></li>
+</ul></p></result>
+</taskbody>
+</task>
+<?Pub *0000003609?>
Propchange: incubator/derby/docs/trunk/src/adminguide/tadminovrunsrvprgm.dita
------------------------------------------------------------------------------
svn:eol-style = native
Modified: incubator/derby/docs/trunk/src/adminguide/tadminspace43.dita
URL: http://svn.apache.org/viewcvs/incubator/derby/docs/trunk/src/adminguide/tadminspace43.dita?view=diff&r1=159547&r2=159548
==============================================================================
--- incubator/derby/docs/trunk/src/adminguide/tadminspace43.dita (original)
+++ incubator/derby/docs/trunk/src/adminguide/tadminspace43.dita Wed Mar 30 16:26:36 2005
@@ -1,48 +1,48 @@
-<?xml version="1.0" encoding="utf-8"?>
-
-<!DOCTYPE task PUBLIC "-//IBM//DTD DITA Task//EN"
- "../dtd/task.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.
--->
-<task id="tadminspace43" xml:lang="en-us">
-<title>Reclaiming unused space</title>
-<prolog><metadata>
-<keywords><indexterm>Compressing tables and indexes</indexterm></keywords>
-</metadata></prolog>
-<taskbody>
-<context> <p>If you determine that a table and its indexes have a significant
-amount of unused space, use the SYSCS_UTIL.SYSCS_COMPRESS_TABLE procedure
-to reclaim that space. The procedure returns the reclaimed space to the operating
-system. By default, the SYSCS_UTIL.SYSCS_COMPRESS_TABLE procedure instructs <ph
-conref="adminconrefs.dita#prod/productshortname"></ph> to compress the table
-and its related indexes concurrently, which can use a lot of temporary disk
-space and memory.</p></context>
-<example><p> For example, after you have determined that the FlightAvailability
-table and its related indexes have too much unused space, you could reclaim
-that space with the following command:</p><codeblock>call SYSCS_UTIL.SYSCS_COMPRESS_TABLE('APP', 'FLIGHTAVAILABILITY', 0);</codeblock><p> The
-third parameter in the SYSCS_UTIL.SYSCS_COMPRESS_TABLE() procedure determines
-whether the operation will run in sequential or non-sequential mode. If you
-specify <codeph>0</codeph> for the third argument in the procedure, the operation
-will run in non-sequential mode. In sequential mode,<ph conref="adminconrefs.dita#prod/productshortname"></ph> compresses
-the table and indexes sequentially, one at a time. Sequential compression
-uses less memory and disk space but is slower. To force the operation to run
-in sequential mode, substitute a non-zero smallint value for the third argument.
-The following example shows how to force the procedure to run in sequential
-mode:</p><codeblock>call SYSCS_UTIL.SYSCS_COMPRESS_TABLE('APP', 'FLIGHTAVAILABILITY', 1);</codeblock><?Pub Caret1?></example>
-<postreq>For more information about this command, see the <cite><ph conref="adminconrefs.dita#pub/citref"></ph></cite>.</postreq>
-</taskbody>
-</task>
-<?Pub *0000002759?>
+<?xml version="1.0" encoding="utf-8"?>
+
+<!DOCTYPE task PUBLIC "-//IBM//DTD DITA Task//EN"
+ "../dtd/task.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.
+-->
+<task id="tadminspace43" xml:lang="en-us">
+<title>Reclaiming unused space</title>
+<prolog><metadata>
+<keywords><indexterm>Compressing tables and indexes</indexterm></keywords>
+</metadata></prolog>
+<taskbody>
+<context> <p>If you determine that a table and its indexes have a significant
+amount of unused space, use the SYSCS_UTIL.SYSCS_COMPRESS_TABLE procedure
+to reclaim that space. The procedure returns the reclaimed space to the operating
+system. By default, the SYSCS_UTIL.SYSCS_COMPRESS_TABLE procedure instructs <ph
+conref="adminconrefs.dita#prod/productshortname"></ph> to compress the table
+and its related indexes concurrently, which can use a lot of temporary disk
+space and memory.</p></context>
+<example><p> For example, after you have determined that the FlightAvailability
+table and its related indexes have too much unused space, you could reclaim
+that space with the following command:</p><codeblock>call SYSCS_UTIL.SYSCS_COMPRESS_TABLE('APP', 'FLIGHTAVAILABILITY', 0);</codeblock><p> The
+third parameter in the SYSCS_UTIL.SYSCS_COMPRESS_TABLE() procedure determines
+whether the operation will run in sequential or non-sequential mode. If you
+specify <codeph>0</codeph> for the third argument in the procedure, the operation
+will run in non-sequential mode. In sequential mode,<ph conref="adminconrefs.dita#prod/productshortname"></ph> compresses
+the table and indexes sequentially, one at a time. Sequential compression
+uses less memory and disk space but is slower. To force the operation to run
+in sequential mode, substitute a non-zero smallint value for the third argument.
+The following example shows how to force the procedure to run in sequential
+mode:</p><codeblock>call SYSCS_UTIL.SYSCS_COMPRESS_TABLE('APP', 'FLIGHTAVAILABILITY', 1);</codeblock><?Pub Caret1?></example>
+<postreq>For more information about this command, see the <cite><ph conref="adminconrefs.dita#pub/citref"></ph></cite>.</postreq>
+</taskbody>
+</task>
+<?Pub *0000002759?>
Propchange: incubator/derby/docs/trunk/src/adminguide/tadminspace43.dita
------------------------------------------------------------------------------
svn:eol-style = native
Modified: incubator/derby/docs/trunk/src/adminguide/tadmintracefacility.dita
URL: http://svn.apache.org/viewcvs/incubator/derby/docs/trunk/src/adminguide/tadmintracefacility.dita?view=diff&r1=159547&r2=159548
==============================================================================
--- incubator/derby/docs/trunk/src/adminguide/tadmintracefacility.dita (original)
+++ incubator/derby/docs/trunk/src/adminguide/tadmintracefacility.dita Wed Mar 30 16:26:36 2005
@@ -1,35 +1,35 @@
-<?xml version="1.0" encoding="utf-8"?>
-
-<!DOCTYPE task PUBLIC "-//IBM//DTD DITA Task//EN"
- "../dtd/task.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.
--->
-<task id="tadmintracefacility" xml:lang="en-us">
-<title>Controlling tracing by using the trace facility</title>
-<prolog><metadata>
-<keywords><indexterm>Network Server<indexterm>trace facility</indexterm></indexterm>
-<indexterm>Trace facility<indexterm>for the Network Server</indexterm></indexterm>
-</keywords>
-</metadata></prolog>
-<taskbody>
-<context> <p>You will use the trace facility only if you are working with
-technical support and they require the additional information provided in
-this file.</p> </context>
-<postreq><p>See <xref href="cadminservlet98430.dita#cadminservlet98430"></xref> for
-information about managing the trace facility using the servlet interface. </p></postreq>
-</taskbody>
-</task>
-<?Pub *0000001536?>
+<?xml version="1.0" encoding="utf-8"?>
+
+<!DOCTYPE task PUBLIC "-//IBM//DTD DITA Task//EN"
+ "../dtd/task.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.
+-->
+<task id="tadmintracefacility" xml:lang="en-us">
+<title>Controlling tracing by using the trace facility</title>
+<prolog><metadata>
+<keywords><indexterm>Network Server<indexterm>trace facility</indexterm></indexterm>
+<indexterm>Trace facility<indexterm>for the Network Server</indexterm></indexterm>
+</keywords>
+</metadata></prolog>
+<taskbody>
+<context> <p>You will use the trace facility only if you are working with
+technical support and they require the additional information provided in
+this file.</p> </context>
+<postreq><p>See <xref href="cadminservlet98430.dita#cadminservlet98430"></xref> for
+information about managing the trace facility using the servlet interface. </p></postreq>
+</taskbody>
+</task>
+<?Pub *0000001536?>
Propchange: incubator/derby/docs/trunk/src/adminguide/tadmintracefacility.dita
------------------------------------------------------------------------------
svn:eol-style = native
Modified: incubator/derby/docs/trunk/src/devguide/cdevadvjdbc18939.dita
URL: http://svn.apache.org/viewcvs/incubator/derby/docs/trunk/src/devguide/cdevadvjdbc18939.dita?view=diff&r1=159547&r2=159548
==============================================================================
--- incubator/derby/docs/trunk/src/devguide/cdevadvjdbc18939.dita (original)
+++ incubator/derby/docs/trunk/src/devguide/cdevadvjdbc18939.dita Wed Mar 30 16:26:36 2005
@@ -1,47 +1,47 @@
-<?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="cdevadvjdbc18939">
-<title>IDEs and multiple JVMs</title>
-<prolog>
-</prolog>
-<conbody>
-<p>When you use an integrated development environment (IDE) to build a Java
-application, you can launch the application from within the IDE at any point
-in the development process. Typically, the IDE launches a JVM dedicated to
-the application. When the application completes, the JVM exits. Any database
-connections established by the application are closed. </p>
-<p>During the development of a database application, most IDEs allow you to
-test individual database connections and queries without running the entire
-application. When you test an individual database connection or query (which
-requires a database connection), the IDE might launch a JVM that runs in a
-specialized testing environment. In this case, when a test completes, the
-JVM remains active and available for further testing, and the database connection
-established during the test remains open.</p>
-<p>Because of the behaviors of the IDE described above, if you use the embedded <ph conref="devconrefs.dita#prod/productshortname"></ph> JDBC
-driver, you may encounter errors connecting in the following situations:</p>
-<ul>
-<li>You test an individual query or database connection and then try to run
-an application that uses the same database as the tested feature.
-<p>The
-database connection established by testing the connection or query stays open,
-and prevents the application from establishing a connection to the same database.</p></li>
-<li>You run an application, and before it completes (for example, while it
-waits for user input), you attempt to run a second application or to test
-a connection or query that uses the same database as the first application.</li>
-</ul>
-</conbody></concept>
+<?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="cdevadvjdbc18939">
+<title>IDEs and multiple JVMs</title>
+<prolog>
+</prolog>
+<conbody>
+<p>When you use an integrated development environment (IDE) to build a Java
+application, you can launch the application from within the IDE at any point
+in the development process. Typically, the IDE launches a JVM dedicated to
+the application. When the application completes, the JVM exits. Any database
+connections established by the application are closed. </p>
+<p>During the development of a database application, most IDEs allow you to
+test individual database connections and queries without running the entire
+application. When you test an individual database connection or query (which
+requires a database connection), the IDE might launch a JVM that runs in a
+specialized testing environment. In this case, when a test completes, the
+JVM remains active and available for further testing, and the database connection
+established during the test remains open.</p>
+<p>Because of the behaviors of the IDE described above, if you use the embedded <ph conref="devconrefs.dita#prod/productshortname"></ph> JDBC
+driver, you may encounter errors connecting in the following situations:</p>
+<ul>
+<li>You test an individual query or database connection and then try to run
+an application that uses the same database as the tested feature.
+<p>The
+database connection established by testing the connection or query stays open,
+and prevents the application from establishing a connection to the same database.</p></li>
+<li>You run an application, and before it completes (for example, while it
+waits for user input), you attempt to run a second application or to test
+a connection or query that uses the same database as the first application.</li>
+</ul>
+</conbody></concept>
Propchange: incubator/derby/docs/trunk/src/devguide/cdevadvjdbc18939.dita
------------------------------------------------------------------------------
svn:eol-style = native
Modified: incubator/derby/docs/trunk/src/devguide/cdevadvjdbc32436.dita
URL: http://svn.apache.org/viewcvs/incubator/derby/docs/trunk/src/devguide/cdevadvjdbc32436.dita?view=diff&r1=159547&r2=159548
==============================================================================
--- incubator/derby/docs/trunk/src/devguide/cdevadvjdbc32436.dita (original)
+++ incubator/derby/docs/trunk/src/devguide/cdevadvjdbc32436.dita Wed Mar 30 16:26:36 2005
@@ -1,39 +1,39 @@
-<?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="cdevadvjdbc32436">
-<title>Using Derby with IDEs</title>
-<prolog><metadata>
-<keywords>
-<indexterm>IDEs<indexterm>using Derby with</indexterm><indexterm>and need to use server framework</indexterm></indexterm>
-</keywords>
-</metadata>
-</prolog>
-<conbody>
-<p>When you use an integrated development environment (IDE) to develop an
-embedded <ph conref="devconrefs.dita#prod/productshortname"></ph> application, you might need to run <ph conref="devconrefs.dita#prod/productshortname"></ph> within
-a server framework. This is because an IDE might try connecting to the database
-from two different JVMs, whereas only a single JVM instance should connect
-to a <ph conref="devconrefs.dita#prod/productshortname"></ph> database at one time, as described in <xref href="cdevdvlp96597.dita#cdevdvlp96597"/> (multiple connections from the same JVM are allowed). </p>
-<p>An "embedded <ph conref="devconrefs.dita#prod/productshortname"></ph> application" is one which runs in the
-same JVM as the application. Such an application uses the embedded <ph conref="devconrefs.dita#prod/productshortname"></ph> driver
-(<i>org.apache.derby.jdbc.EmbeddedDriver</i>; see <xref href="cdevdvlp40170.dita#cdevdvlp40170"/>) and connection URL (<codeph><i>jdbc:derby:databaseName</i></codeph>; see <xref href="rdevdvlp38881.dita#rdevdvlp38881"/>). If you use this
-driver name or connection URL from the IDE, when the IDE tries to open a second connection
-to the same database with the embedded <ph conref="devconrefs.dita#prod/productshortname"></ph>, the attempt fails. Two
-JVMs cannot connect to the same database in embedded mode. This situation
-is described in more detail in <xref href="cdevadvjdbc18939.dita#cdevadvjdbc18939"/>.</p>
-</conbody></concept>
+<?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="cdevadvjdbc32436">
+<title>Using Derby with IDEs</title>
+<prolog><metadata>
+<keywords>
+<indexterm>IDEs<indexterm>using Derby with</indexterm><indexterm>and need to use server framework</indexterm></indexterm>
+</keywords>
+</metadata>
+</prolog>
+<conbody>
+<p>When you use an integrated development environment (IDE) to develop an
+embedded <ph conref="devconrefs.dita#prod/productshortname"></ph> application, you might need to run <ph conref="devconrefs.dita#prod/productshortname"></ph> within
+a server framework. This is because an IDE might try connecting to the database
+from two different JVMs, whereas only a single JVM instance should connect
+to a <ph conref="devconrefs.dita#prod/productshortname"></ph> database at one time, as described in <xref href="cdevdvlp96597.dita#cdevdvlp96597"/> (multiple connections from the same JVM are allowed). </p>
+<p>An "embedded <ph conref="devconrefs.dita#prod/productshortname"></ph> application" is one which runs in the
+same JVM as the application. Such an application uses the embedded <ph conref="devconrefs.dita#prod/productshortname"></ph> driver
+(<i>org.apache.derby.jdbc.EmbeddedDriver</i>; see <xref href="cdevdvlp40170.dita#cdevdvlp40170"/>) and connection URL (<codeph><i>jdbc:derby:databaseName</i></codeph>; see <xref href="rdevdvlp38881.dita#rdevdvlp38881"/>). If you use this
+driver name or connection URL from the IDE, when the IDE tries to open a second connection
+to the same database with the embedded <ph conref="devconrefs.dita#prod/productshortname"></ph>, the attempt fails. Two
+JVMs cannot connect to the same database in embedded mode. This situation
+is described in more detail in <xref href="cdevadvjdbc18939.dita#cdevadvjdbc18939"/>.</p>
+</conbody></concept>
Propchange: incubator/derby/docs/trunk/src/devguide/cdevadvjdbc32436.dita
------------------------------------------------------------------------------
svn:eol-style = native
Modified: incubator/derby/docs/trunk/src/devguide/cdevadvjdbc35053.dita
URL: http://svn.apache.org/viewcvs/incubator/derby/docs/trunk/src/devguide/cdevadvjdbc35053.dita?view=diff&r1=159547&r2=159548
==============================================================================
--- incubator/derby/docs/trunk/src/devguide/cdevadvjdbc35053.dita (original)
+++ incubator/derby/docs/trunk/src/devguide/cdevadvjdbc35053.dita Wed Mar 30 16:26:36 2005
@@ -1,29 +1,29 @@
-<?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="cdevadvjdbc35053">
-<title>Developing Tools and Using Derby with an IDE</title>
-<prolog>
-</prolog>
-<conbody>
-<p>Applications such as database tools are designed to work with databases
-whose schemas and contents are unknown in advance. This chapter discusses
-a few topics useful for such applications.</p>
-<ul>
-<li><xref href="cdevadvjdbc41138.dita#cdevadvjdbc41138"/></li>
-</ul>
-</conbody></concept>
+<?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="cdevadvjdbc35053">
+<title>Developing Tools and Using Derby with an IDE</title>
+<prolog>
+</prolog>
+<conbody>
+<p>Applications such as database tools are designed to work with databases
+whose schemas and contents are unknown in advance. This chapter discusses
+a few topics useful for such applications.</p>
+<ul>
+<li><xref href="cdevadvjdbc41138.dita#cdevadvjdbc41138"/></li>
+</ul>
+</conbody></concept>
Propchange: incubator/derby/docs/trunk/src/devguide/cdevadvjdbc35053.dita
------------------------------------------------------------------------------
svn:eol-style = native
Modified: incubator/derby/docs/trunk/src/devguide/cdevadvjdbc41138.dita
URL: http://svn.apache.org/viewcvs/incubator/derby/docs/trunk/src/devguide/cdevadvjdbc41138.dita?view=diff&r1=159547&r2=159548
==============================================================================
--- incubator/derby/docs/trunk/src/devguide/cdevadvjdbc41138.dita (original)
+++ incubator/derby/docs/trunk/src/devguide/cdevadvjdbc41138.dita Wed Mar 30 16:26:36 2005
@@ -1,53 +1,53 @@
-<?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="cdevadvjdbc41138">
-<title>Offering Connection Choices to the User</title>
-<prolog><metadata>
-<keywords>
-<indexterm>java.sql.Driver.getPropertyInfo</indexterm>
-<indexterm>Available databases<indexterm>list of provided by
-databaseName attribute</indexterm></indexterm>
-</keywords>
-</metadata>
-</prolog>
-<conbody>
-<p>JDBC's <i>java.sql.Driver.getPropertyInfo</i> method
-allows a generic GUI tool to determine the properties for which it should
-prompt a user in order to get enough information to connect to a database.
-Depending on the values the user has supplied so far, additional values might
-become necessary. It might be necessary to iterate though several calls to <codeph><i>getPropertyInfo</i></codeph>. If no more properties are necessary,
-the call returns an array of zero length.</p>
-<p>In a <ph conref="devconrefs.dita#prod/productshortname"></ph> system, do not use the method against an instance of <i>org.apache.derby.jdbc.EmbeddedDriver</i>. Instead, request
-the JDBC driver from the driver manager:</p>
-<codeblock>java.sql.DriverManager.getDriver(
- "jdbc:derby:").getPropertyInfo(<i>URL</i>, <i>Prop</i>)</codeblock>
-<p>In a <ph conref="devconrefs.dita#prod/productshortname"></ph> system, the properties returned in the <i>DriverPropertyInfo</i> object are connection URL attributes, including a list of booted
-databases in a system (the <codeph><i>databaseName</i></codeph> attribute).</p>
-<p>Databases in a system are not automatically booted until you connect with
-them. You can configure your system to retain the former behavior, in which
-case the steps described in this section will continue to work. See <i>"derby.system.bootAll" </i> in <cite><ph conref="devconrefs.dita#pub/cittuning"></ph></cite>.</p>
-<p><i>getPropertyInfo</i> requires a connection URL and a <codeph><i>Properties</i></codeph> object as parameters. Typically, what
-you pass are values that you will use in a future call to <codeph><i>java.sql.DriverManager.getConnection</i></codeph> when you actually connect
-to the database. For information about setting attributes in calls to <codeph><i>java.sql.DriverManager.getConnection</i></codeph>, see <xref href="rdevdvlp22102.dita#rdevdvlp22102"/>.</p>
-<p>A call to <i>getPropertyInfo</i> with parameters that
-contain sufficient information to connect successfully returns an array of
-zero length. (Receiving this zero-length array does not <i>guarantee</i> that the <codeph><i>getConnection</i></codeph> call
-will succeed, because something else could go wrong.)</p>
-<p>Repeat calls to <i>getPropertyInfo</i> until it returns
-a zero-length array or none of the properties remaining are desired.</p>
-</conbody></concept>
+<?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="cdevadvjdbc41138">
+<title>Offering Connection Choices to the User</title>
+<prolog><metadata>
+<keywords>
+<indexterm>java.sql.Driver.getPropertyInfo</indexterm>
+<indexterm>Available databases<indexterm>list of provided by
+databaseName attribute</indexterm></indexterm>
+</keywords>
+</metadata>
+</prolog>
+<conbody>
+<p>JDBC's <i>java.sql.Driver.getPropertyInfo</i> method
+allows a generic GUI tool to determine the properties for which it should
+prompt a user in order to get enough information to connect to a database.
+Depending on the values the user has supplied so far, additional values might
+become necessary. It might be necessary to iterate though several calls to <codeph><i>getPropertyInfo</i></codeph>. If no more properties are necessary,
+the call returns an array of zero length.</p>
+<p>In a <ph conref="devconrefs.dita#prod/productshortname"></ph> system, do not use the method against an instance of <i>org.apache.derby.jdbc.EmbeddedDriver</i>. Instead, request
+the JDBC driver from the driver manager:</p>
+<codeblock>java.sql.DriverManager.getDriver(
+ "jdbc:derby:").getPropertyInfo(<i>URL</i>, <i>Prop</i>)</codeblock>
+<p>In a <ph conref="devconrefs.dita#prod/productshortname"></ph> system, the properties returned in the <i>DriverPropertyInfo</i> object are connection URL attributes, including a list of booted
+databases in a system (the <codeph><i>databaseName</i></codeph> attribute).</p>
+<p>Databases in a system are not automatically booted until you connect with
+them. You can configure your system to retain the former behavior, in which
+case the steps described in this section will continue to work. See <i>"derby.system.bootAll" </i> in <cite><ph conref="devconrefs.dita#pub/cittuning"></ph></cite>.</p>
+<p><i>getPropertyInfo</i> requires a connection URL and a <codeph><i>Properties</i></codeph> object as parameters. Typically, what
+you pass are values that you will use in a future call to <codeph><i>java.sql.DriverManager.getConnection</i></codeph> when you actually connect
+to the database. For information about setting attributes in calls to <codeph><i>java.sql.DriverManager.getConnection</i></codeph>, see <xref href="rdevdvlp22102.dita#rdevdvlp22102"/>.</p>
+<p>A call to <i>getPropertyInfo</i> with parameters that
+contain sufficient information to connect successfully returns an array of
+zero length. (Receiving this zero-length array does not <i>guarantee</i> that the <codeph><i>getConnection</i></codeph> call
+will succeed, because something else could go wrong.)</p>
+<p>Repeat calls to <i>getPropertyInfo</i> until it returns
+a zero-length array or none of the properties remaining are desired.</p>
+</conbody></concept>
Propchange: incubator/derby/docs/trunk/src/devguide/cdevadvjdbc41138.dita
------------------------------------------------------------------------------
svn:eol-style = native
Modified: incubator/derby/docs/trunk/src/devguide/cdevbabejgjd.dita
URL: http://svn.apache.org/viewcvs/incubator/derby/docs/trunk/src/devguide/cdevbabejgjd.dita?view=diff&r1=159547&r2=159548
==============================================================================
--- incubator/derby/docs/trunk/src/devguide/cdevbabejgjd.dita (original)
+++ incubator/derby/docs/trunk/src/devguide/cdevbabejgjd.dita Wed Mar 30 16:26:36 2005
@@ -1,30 +1,30 @@
-<?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="cdevbabejgjd">
-<title>Granting permissions to Derby</title>
-<prolog><metadata>
-<keywords>
-<indexterm>Permissions<indexterm>granting to Derby</indexterm></indexterm>
-</keywords>
-</metadata>
-</prolog>
-<conbody>
-<p>The following section discusses which permissions should be granted to <ph conref="devconrefs.dita#prod/productshortname"></ph> (the
-code base <i>derby.jar</i>).</p>
-<p>See Default Policy Implementation and Policy File Syntax at <synph><var>http://java.sun.com/j2se/1.4.2/docs/guide/security/PolicyFiles.html</var></synph> for more information about creating policy files.</p>
-</conbody></concept>
+<?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="cdevbabejgjd">
+<title>Granting permissions to Derby</title>
+<prolog><metadata>
+<keywords>
+<indexterm>Permissions<indexterm>granting to Derby</indexterm></indexterm>
+</keywords>
+</metadata>
+</prolog>
+<conbody>
+<p>The following section discusses which permissions should be granted to <ph conref="devconrefs.dita#prod/productshortname"></ph> (the
+code base <i>derby.jar</i>).</p>
+<p>See Default Policy Implementation and Policy File Syntax at <synph><var>http://java.sun.com/j2se/1.4.2/docs/guide/security/PolicyFiles.html</var></synph> for more information about creating policy files.</p>
+</conbody></concept>
Propchange: incubator/derby/docs/trunk/src/devguide/cdevbabejgjd.dita
------------------------------------------------------------------------------
svn:eol-style = native
Modified: incubator/derby/docs/trunk/src/devguide/cdevcbabejdfj.dita
URL: http://svn.apache.org/viewcvs/incubator/derby/docs/trunk/src/devguide/cdevcbabejdfj.dita?view=diff&r1=159547&r2=159548
==============================================================================
--- incubator/derby/docs/trunk/src/devguide/cdevcbabejdfj.dita (original)
+++ incubator/derby/docs/trunk/src/devguide/cdevcbabejdfj.dita Wed Mar 30 16:26:36 2005
@@ -1,38 +1,38 @@
-<?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="cdevcbabejdfj">
-<title>Running Derby under a security manager</title>
-<prolog><metadata>
-<keywords>
-<indexterm>Policy files<indexterm>and Derby permissions</indexterm></indexterm>
-<indexterm>Java 2 Security Manager</indexterm>
-</keywords>
-</metadata>
-</prolog>
-<conbody>
-<p>When running within an application or application server with a Java 2
-Security Manager enabled, <ph conref="devconrefs.dita#prod/productshortname"></ph> must be granted certain permissions
-to execute and access database files. Those permissions are described in "<xref href="cdevbabejgjd.dita#cdevbabejgjd"/>", below.</p>
-<p>For more information about permissions and examples of creating permission
-objects and granting permissions, see the Security Architecture specification
-at <synph><var>http://java.sun.com/j2se/1.4.2/docs/guide/security/PolicyFiles.html</var></synph>.</p>
-<ul>
-<li><xref href="cdevbabejgjd.dita#cdevbabejgjd"/></li>
-<li><xref href="cdevcsecure871387.dita#cdevcsecure871387"/></li>
-</ul>
-</conbody></concept>
+<?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="cdevcbabejdfj">
+<title>Running Derby under a security manager</title>
+<prolog><metadata>
+<keywords>
+<indexterm>Policy files<indexterm>and Derby permissions</indexterm></indexterm>
+<indexterm>Java 2 Security Manager</indexterm>
+</keywords>
+</metadata>
+</prolog>
+<conbody>
+<p>When running within an application or application server with a Java 2
+Security Manager enabled, <ph conref="devconrefs.dita#prod/productshortname"></ph> must be granted certain permissions
+to execute and access database files. Those permissions are described in "<xref href="cdevbabejgjd.dita#cdevbabejgjd"/>", below.</p>
+<p>For more information about permissions and examples of creating permission
+objects and granting permissions, see the Security Architecture specification
+at <synph><var>http://java.sun.com/j2se/1.4.2/docs/guide/security/PolicyFiles.html</var></synph>.</p>
+<ul>
+<li><xref href="cdevbabejgjd.dita#cdevbabejgjd"/></li>
+<li><xref href="cdevcsecure871387.dita#cdevcsecure871387"/></li>
+</ul>
+</conbody></concept>
Propchange: incubator/derby/docs/trunk/src/devguide/cdevcbabejdfj.dita
------------------------------------------------------------------------------
svn:eol-style = native
Modified: incubator/derby/docs/trunk/src/devguide/cdevconcepts10914.dita
URL: http://svn.apache.org/viewcvs/incubator/derby/docs/trunk/src/devguide/cdevconcepts10914.dita?view=diff&r1=159547&r2=159548
==============================================================================
--- incubator/derby/docs/trunk/src/devguide/cdevconcepts10914.dita (original)
+++ incubator/derby/docs/trunk/src/devguide/cdevconcepts10914.dita Wed Mar 30 16:26:36 2005
@@ -1,37 +1,37 @@
-<?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="cdevconcepts10914">
-<title>Multi-user database access</title>
-<prolog><metadata>
-<keywords>
-<indexterm>Multi-user database access<indexterm>programming
-for</indexterm></indexterm>
-</keywords>
-</metadata>
-</prolog>
-<conbody>
-<p>Multi-user database access is possible if <ph conref="devconrefs.dita#prod/productshortname"></ph> is running inside
-a server framework.</p>
-<p>If more than one client application tries to modify the same data, the
-connection that gets the table first gets the lock on the data (either specific
-rows or the entire table). The second connection has to wait until the first
-connection commits or rolls back the transaction in order to access the data.
-If two connections are only querying and not modifying data, they can both
-access the same data at the same time because they can each get a shared lock.
-For more information, see <xref href="cdevconcepts30291.dita#cdevconcepts30291"/>.</p>
-</conbody></concept>
+<?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="cdevconcepts10914">
+<title>Multi-user database access</title>
+<prolog><metadata>
+<keywords>
+<indexterm>Multi-user database access<indexterm>programming
+for</indexterm></indexterm>
+</keywords>
+</metadata>
+</prolog>
+<conbody>
+<p>Multi-user database access is possible if <ph conref="devconrefs.dita#prod/productshortname"></ph> is running inside
+a server framework.</p>
+<p>If more than one client application tries to modify the same data, the
+connection that gets the table first gets the lock on the data (either specific
+rows or the entire table). The second connection has to wait until the first
+connection commits or rolls back the transaction in order to access the data.
+If two connections are only querying and not modifying data, they can both
+access the same data at the same time because they can each get a shared lock.
+For more information, see <xref href="cdevconcepts30291.dita#cdevconcepts30291"/>.</p>
+</conbody></concept>
Propchange: incubator/derby/docs/trunk/src/devguide/cdevconcepts10914.dita
------------------------------------------------------------------------------
svn:eol-style = native
Modified: incubator/derby/docs/trunk/src/devguide/cdevconcepts14433.dita
URL: http://svn.apache.org/viewcvs/incubator/derby/docs/trunk/src/devguide/cdevconcepts14433.dita?view=diff&r1=159547&r2=159548
==============================================================================
--- incubator/derby/docs/trunk/src/devguide/cdevconcepts14433.dita (original)
+++ incubator/derby/docs/trunk/src/devguide/cdevconcepts14433.dita Wed Mar 30 16:26:36 2005
@@ -1,39 +1,39 @@
-<?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="cdevconcepts14433">
-<title>Statement versus transaction runtime rollback</title>
-<prolog><metadata>
-<keywords>
-<indexterm>Rollback<indexterm>implicit versus explicit</indexterm></indexterm>
-</keywords>
-</metadata>
-</prolog>
-<conbody>
-<p>When an SQL statement generates an exception, this exception results
-in a <i>runtime rollback</i>. A runtime rollback is a system-generated
-rollback of a statement or transaction by <ph conref="devconrefs.dita#prod/productshortname"></ph>, as opposed to an explicit <codeph><i>rollback</i></codeph> call from your application.</p>
-<p>Extremely severe exceptions, such as disk-full errors, shut down the system,
-and the transaction is rolled back when the database is next booted. Severe
-exceptions, such as deadlock, cause transaction rollback; <ph conref="devconrefs.dita#prod/productshortname"></ph> rolls
-back all changes since the beginning of the transaction and implicitly begins
-a new transaction. Less severe exceptions, such as syntax errors, result in
-statement rollback; <ph conref="devconrefs.dita#prod/productshortname"></ph> rolls back only changes made by the statement
-that caused the error. The application developer can insert code to explicitly
-roll back the entire transaction if desired.</p>
-<p><ph conref="devconrefs.dita#prod/productshortname"></ph> supports partial rollback through the use of savepoints. See the <cite>IBM <ph conref="devconrefs.dita#pub/citref"></ph></cite> for more information.</p>
-</conbody></concept>
+<?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="cdevconcepts14433">
+<title>Statement versus transaction runtime rollback</title>
+<prolog><metadata>
+<keywords>
+<indexterm>Rollback<indexterm>implicit versus explicit</indexterm></indexterm>
+</keywords>
+</metadata>
+</prolog>
+<conbody>
+<p>When an SQL statement generates an exception, this exception results
+in a <i>runtime rollback</i>. A runtime rollback is a system-generated
+rollback of a statement or transaction by <ph conref="devconrefs.dita#prod/productshortname"></ph>, as opposed to an explicit <codeph><i>rollback</i></codeph> call from your application.</p>
+<p>Extremely severe exceptions, such as disk-full errors, shut down the system,
+and the transaction is rolled back when the database is next booted. Severe
+exceptions, such as deadlock, cause transaction rollback; <ph conref="devconrefs.dita#prod/productshortname"></ph> rolls
+back all changes since the beginning of the transaction and implicitly begins
+a new transaction. Less severe exceptions, such as syntax errors, result in
+statement rollback; <ph conref="devconrefs.dita#prod/productshortname"></ph> rolls back only changes made by the statement
+that caused the error. The application developer can insert code to explicitly
+roll back the entire transaction if desired.</p>
+<p><ph conref="devconrefs.dita#prod/productshortname"></ph> supports partial rollback through the use of savepoints. See the <cite>IBM <ph conref="devconrefs.dita#pub/citref"></ph></cite> for more information.</p>
+</conbody></concept>
Propchange: incubator/derby/docs/trunk/src/devguide/cdevconcepts14433.dita
------------------------------------------------------------------------------
svn:eol-style = native