db-derby-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From chaa...@apache.org
Subject svn commit: r745679 - in /db/derby/docs/trunk/src: adminguide/ devguide/ getstart/ ref/ tuning/
Date Wed, 18 Feb 2009 22:39:21 GMT
Author: chaase3
Date: Wed Feb 18 22:39:19 2009
New Revision: 745679

URL: http://svn.apache.org/viewvc?rev=745679&view=rev
Log:
DERBY-2389: DOCS - Move Derby system and properties info from Tuning Guide into Reference Manual

This patch moves the topics on working with properties from the Tuning Guide to the Developer's Guide and corrects cross-references to point to the right places.

Patch: DERBY-2389-phase2.diff

Added:
    db/derby/docs/trunk/src/devguide/cdevsetprop11108.dita   (with props)
    db/derby/docs/trunk/src/devguide/cdevsetprop11561.dita   (with props)
    db/derby/docs/trunk/src/devguide/cdevsetprop12821.dita   (with props)
    db/derby/docs/trunk/src/devguide/cdevsetprop13074.dita   (with props)
    db/derby/docs/trunk/src/devguide/cdevsetprop16827.dita   (with props)
    db/derby/docs/trunk/src/devguide/cdevsetprop23308.dita   (with props)
    db/derby/docs/trunk/src/devguide/cdevsetprop24222.dita   (with props)
    db/derby/docs/trunk/src/devguide/cdevsetprop24843.dita   (with props)
    db/derby/docs/trunk/src/devguide/cdevsetprop32443.dita   (with props)
    db/derby/docs/trunk/src/devguide/cdevsetprop34818.dita   (with props)
    db/derby/docs/trunk/src/devguide/cdevsetprop44147.dita   (with props)
    db/derby/docs/trunk/src/devguide/cdevsetprop824451.dita   (with props)
    db/derby/docs/trunk/src/devguide/cdevsetprop824500.dita   (with props)
    db/derby/docs/trunk/src/devguide/cdevsetprop824533.dita   (with props)
    db/derby/docs/trunk/src/devguide/cdevsetprop824615.dita   (with props)
    db/derby/docs/trunk/src/devguide/cdevsetprop824983.dita   (with props)
Removed:
    db/derby/docs/trunk/src/tuning/ctunsetprop1003847.dita
    db/derby/docs/trunk/src/tuning/ctunsetprop11108.dita
    db/derby/docs/trunk/src/tuning/ctunsetprop11561.dita
    db/derby/docs/trunk/src/tuning/ctunsetprop12821.dita
    db/derby/docs/trunk/src/tuning/ctunsetprop13074.dita
    db/derby/docs/trunk/src/tuning/ctunsetprop16827.dita
    db/derby/docs/trunk/src/tuning/ctunsetprop23308.dita
    db/derby/docs/trunk/src/tuning/ctunsetprop24222.dita
    db/derby/docs/trunk/src/tuning/ctunsetprop24843.dita
    db/derby/docs/trunk/src/tuning/ctunsetprop32443.dita
    db/derby/docs/trunk/src/tuning/ctunsetprop34818.dita
    db/derby/docs/trunk/src/tuning/ctunsetprop38343.dita
    db/derby/docs/trunk/src/tuning/ctunsetprop44147.dita
    db/derby/docs/trunk/src/tuning/ctunsetprop824451.dita
    db/derby/docs/trunk/src/tuning/ctunsetprop824500.dita
    db/derby/docs/trunk/src/tuning/ctunsetprop824533.dita
    db/derby/docs/trunk/src/tuning/ctunsetprop824615.dita
    db/derby/docs/trunk/src/tuning/ctunsetprop824983.dita
Modified:
    db/derby/docs/trunk/src/adminguide/cadminlockvti83889.dita
    db/derby/docs/trunk/src/devguide/cdevconcepts22300.dita
    db/derby/docs/trunk/src/devguide/cdevcsecure864692.dita
    db/derby/docs/trunk/src/devguide/cdevdgpref23947.dita
    db/derby/docs/trunk/src/devguide/cdevdvlp13018.dita
    db/derby/docs/trunk/src/devguide/cdevdvlp39943.dita
    db/derby/docs/trunk/src/devguide/cdevdvlp846110.dita
    db/derby/docs/trunk/src/devguide/derbydev.ditamap
    db/derby/docs/trunk/src/devguide/tdevcsecure81850.dita
    db/derby/docs/trunk/src/getstart/rgsdocs17307.dita
    db/derby/docs/trunk/src/ref/crefproper22250.dita
    db/derby/docs/trunk/src/ref/crefproper51399.dita
    db/derby/docs/trunk/src/ref/refderby.ditamap
    db/derby/docs/trunk/src/ref/rrefproper24390.dita
    db/derby/docs/trunk/src/ref/rrefproper32213.dita
    db/derby/docs/trunk/src/ref/rrefsqlj31783.dita
    db/derby/docs/trunk/src/tuning/ctunpropref11181.dita
    db/derby/docs/trunk/src/tuning/ctunpropref23947.dita
    db/derby/docs/trunk/src/tuning/tuningderby.ditamap

Modified: db/derby/docs/trunk/src/adminguide/cadminlockvti83889.dita
URL: http://svn.apache.org/viewvc/db/derby/docs/trunk/src/adminguide/cadminlockvti83889.dita?rev=745679&r1=745678&r2=745679&view=diff
==============================================================================
--- db/derby/docs/trunk/src/adminguide/cadminlockvti83889.dita (original)
+++ db/derby/docs/trunk/src/adminguide/cadminlockvti83889.dita Wed Feb 18 22:39:19 2009
@@ -44,8 +44,8 @@
 <note>Use <codeph>derby.locks.deadlockTrace</codeph> with care. Setting this property
 can alter the timing of the application, severely affect performance, and
 produce a very large <codeph>derby.log</codeph> file.</note>
-<p>For information about how to set properties, see
-<ph conref="../conrefs.dita#pub/cittuning"></ph>. For information about the
+<p>For information about working with properties, see the
+<ph conref="../conrefs.dita#pub/citdevelop"></ph>. For information about the
 specific properties that are mentioned in this topic, see the
 <ph conref="../conrefs.dita#pub/citref"></ph>.</p>
 <p>Here is an example of an error message when <ph conref="../conrefs.dita#prod/productshortname"></ph> aborts

Modified: db/derby/docs/trunk/src/devguide/cdevconcepts22300.dita
URL: http://svn.apache.org/viewvc/db/derby/docs/trunk/src/devguide/cdevconcepts22300.dita?rev=745679&r1=745678&r2=745679&view=diff
==============================================================================
--- db/derby/docs/trunk/src/devguide/cdevconcepts22300.dita (original)
+++ db/derby/docs/trunk/src/devguide/cdevconcepts22300.dita Wed Feb 18 22:39:19 2009
@@ -46,7 +46,9 @@
 cases, the current transaction is committed even if you set the isolation level
 in a way that does not change it (that is, if you set it to its current value).
 See <xref href="cdevconcepts15366.dita#cdevconcepts15366"></xref> for details.</p>
-<note>For information about how to choose a particular isolation level, see <cite><ph
-conref="../conrefs.dita#pub/cittuning"></ph></cite>.</note>
+<note>For information about how to choose a particular isolation level, see
+"Shielding users from Derby class-loading events" in <cite><ph
+conref="../conrefs.dita#pub/cittuning"></ph></cite> and
+<xref href="cdevconcepts65864.dita#cdevconcepts65864"></xref>.</note>
 </conbody>
 </concept>

Modified: db/derby/docs/trunk/src/devguide/cdevcsecure864692.dita
URL: http://svn.apache.org/viewvc/db/derby/docs/trunk/src/devguide/cdevcsecure864692.dita?rev=745679&r1=745678&r2=745679&view=diff
==============================================================================
--- db/derby/docs/trunk/src/devguide/cdevcsecure864692.dita (original)
+++ db/derby/docs/trunk/src/devguide/cdevcsecure864692.dita Wed Feb 18 22:39:19 2009
@@ -26,8 +26,9 @@
 <conbody>
 <p>You set the value of this system-wide property once for each user, so you
 can set it several times. To delete a user, remove that user from the file.</p>
-<p>You can define this property in the usual ways- typically in the <i>derby.properties</i> file.
-For more information about setting properties, see <cite><ph conref="../conrefs.dita#pub/cittuning"></ph></cite>.</p>
+<p>You can define this property in the usual ways -- typically in the <i>derby.properties</i> file.
+For more information about setting properties, see 
+<xref href="cdevsetprop34818.dita#cdevsetprop34818"></xref>.</p>
 <p>Here is a sample excerpt from the <i>derby.properties</i> file:</p>
 <codeblock><b># Users definition
 #</b>

Modified: db/derby/docs/trunk/src/devguide/cdevdgpref23947.dita
URL: http://svn.apache.org/viewvc/db/derby/docs/trunk/src/devguide/cdevdgpref23947.dita?rev=745679&r1=745678&r2=745679&view=diff
==============================================================================
--- db/derby/docs/trunk/src/devguide/cdevdgpref23947.dita (original)
+++ db/derby/docs/trunk/src/devguide/cdevdgpref23947.dita Wed Feb 18 22:39:19 2009
@@ -24,25 +24,38 @@
 <prolog></prolog>
 <conbody>
 <ul>
-<li><i><xref href="cdevdvlp19524.dita#cdevdvlp19524"></xref></i>   <p>Basic
-details for using <ph conref="../conrefs.dita#prod/productshortname"></ph>,
-including loading the JDBC driver, specifying a database URL, and starting <ph
-conref="../conrefs.dita#prod/productshortname"></ph>.</p></li>
 <li><i><xref href="cdevstart19524.dita#cdevstart19524"></xref></i>   <p>Explains
 the installation layout.</p></li>
+<li><i><xref href="cdevupgrades.dita#cdevupgrades"></xref></i>   <p>Explains
+how to upgrade a database created with a previous version of
+<ph conref="../conrefs.dita#prod/productshortname"></ph>.</p></li>
+<li><i><xref href="cdevdvlp19524.dita#cdevdvlp19524"></xref></i>   <p>Basic
+details for using <ph conref="../conrefs.dita#prod/productshortname"></ph>,
+including loading the JDBC driver, specifying a database URL, starting <ph
+conref="../conrefs.dita#prod/productshortname"></ph>, and working with
+<ph conref="../conrefs.dita#prod/productshortname"></ph> properties.</p></li>
 <li><i><xref href="cdevdeploy32171.dita#cdevdeploy32171"></xref></i>   <p>An
 overview of different deployment scenarios, and tips for getting the details
 right when deploying applications.</p></li>
+<li><i><xref href="cdevspecial.dita#cdevspecial"></xref></i>   <p>Describes
+how to program database-side JDBC routines, triggers, and table functions.</p></li>
 <li><i><xref href="cdevconcepts19524.dita#cdevconcepts19524"></xref></i> 
  <p>JDBC, cursors, locking and isolation levels, and multiple connections.</p></li>
 <li><i><xref href="cdevresman19524.dita#cdevresman19524"></xref></i>   <p>Information
 for programmers developing back-end components in a J2EE system.</p></li>
+<li><i><xref href="cdevcsecuree.dita#cdevcsecuree"></xref></i>   <p>Describes
+how to use the security features of
+<ph conref="../conrefs.dita#prod/productshortname"></ph>.</p></li>
 <li><i><xref href="cdevadvjdbc35053.dita#cdevadvjdbc35053"></xref></i>   <p>Tips
 for tool designers.</p></li>
 <li><i><xref href="cdevtricks32436.dita#cdevtricks32436"></xref></i>   <p>Insiders'
 tricks of the trade for using SQL.</p></li>
 <li><i><xref href="cdevin10613.dita#cdevin10613"></xref></i>  <p>An overview
 of database localization.</p></li>
+<li><i><xref href="cdevstandards806118.dita#cdevstandards806118"></xref></i>  
+<p>Describes those parts of
+<ph conref="../conrefs.dita#prod/productshortname"></ph> that are non-standard
+or not typical for a database system.</p></li>
 </ul>
 </conbody>
 </concept>

Modified: db/derby/docs/trunk/src/devguide/cdevdvlp13018.dita
URL: http://svn.apache.org/viewvc/db/derby/docs/trunk/src/devguide/cdevdvlp13018.dita?rev=745679&r1=745678&r2=745679&view=diff
==============================================================================
--- db/derby/docs/trunk/src/devguide/cdevdvlp13018.dita (original)
+++ db/derby/docs/trunk/src/devguide/cdevdvlp13018.dita Wed Feb 18 22:39:19 2009
@@ -29,9 +29,8 @@
 <p><ph conref="../conrefs.dita#prod/productshortname"></ph> uses the <i>derby.system.home</i> property
 to determine which directory is its system directory - and thus what databases
 are in its system, where to create new databases, and what configuration parameters
-to use. See <ph conref="../conrefs.dita#pub/cittuning"></ph> and the
-<ph conref="../conrefs.dita#pub/citref"></ph> for
-more information on setting this property.</p>
+to use. See the <ph conref="../conrefs.dita#pub/citref"></ph> for
+more information on this property.</p>
 <p>If you specify a system directory at startup that does not exist, <ph conref="../conrefs.dita#prod/productshortname"></ph> creates
 this new directory - and thus a new system with no databases-automatically.</p>
 </conbody>

Modified: db/derby/docs/trunk/src/devguide/cdevdvlp39943.dita
URL: http://svn.apache.org/viewvc/db/derby/docs/trunk/src/devguide/cdevdvlp39943.dita?rev=745679&r1=745678&r2=745679&view=diff
==============================================================================
--- db/derby/docs/trunk/src/devguide/cdevdvlp39943.dita (original)
+++ db/derby/docs/trunk/src/devguide/cdevdvlp39943.dita Wed Feb 18 22:39:19 2009
@@ -31,7 +31,7 @@
 with this file, you need to create the file yourself. The <i>derby.properties</i> file
 should be in the format created by the <i>java.util.Properties.save</i> method.
 For more information about properties and the <i>derby.properties</i> file,
-see <ph conref="../conrefs.dita#pub/cittuning"></ph> and the
+see <xref href="cdevsetprop34818.dita#cdevsetprop34818"></xref> and the
 <ph conref="../conrefs.dita#pub/citref"></ph>.</p>
 </conbody>
 </concept>

Modified: db/derby/docs/trunk/src/devguide/cdevdvlp846110.dita
URL: http://svn.apache.org/viewvc/db/derby/docs/trunk/src/devguide/cdevdvlp846110.dita?rev=745679&r1=745678&r2=745679&view=diff
==============================================================================
--- db/derby/docs/trunk/src/devguide/cdevdvlp846110.dita (original)
+++ db/derby/docs/trunk/src/devguide/cdevdvlp846110.dita Wed Feb 18 22:39:19 2009
@@ -28,7 +28,9 @@
 </keywords>
 </metadata></prolog>
 <conbody>
-<p>For more information, see "Database-wide properties" in <ph conref="../conrefs.dita#pub/cittuning"></ph>.</p>
+<p>For more information, see
+<xref href="cdevsetprop824451.dita#cdevsetprop824451"></xref> and 
+<xref href="cdevsetprop12821.dita#cdevsetprop12821"></xref>.</p>
 <note>You should work with database-level properties wherever possible.</note>
 </conbody>
 </concept>

Added: db/derby/docs/trunk/src/devguide/cdevsetprop11108.dita
URL: http://svn.apache.org/viewvc/db/derby/docs/trunk/src/devguide/cdevsetprop11108.dita?rev=745679&view=auto
==============================================================================
--- db/derby/docs/trunk/src/devguide/cdevsetprop11108.dita (added)
+++ db/derby/docs/trunk/src/devguide/cdevsetprop11108.dita Wed Feb 18 22:39:19 2009
@@ -0,0 +1,34 @@
+<?xml version="1.0" encoding="utf-8"?>
+<!DOCTYPE concept PUBLIC "-//OASIS//DTD DITA Concept//EN"
+ "../dtd/concept.dtd">
+<!-- 
+Licensed to the Apache Software Foundation (ASF) under one or more
+contributor license agreements.  See the NOTICE file distributed with
+this work for additional information regarding copyright ownership.
+The ASF licenses this file to You 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="cdevsetprop11108" xml:lang="en-us">
+<title>Properties overview</title>
+<shortdesc><ph conref="../conrefs.dita#prod/productshortname"></ph> lets you
+configure behavior or attributes of a system, a specific database, or a specific <i>conglomerate</i> (a
+table or index) through the use of properties.</shortdesc>
+<prolog></prolog>
+<conbody>
+<p>Examples of behavior or attributes that you can configure are:   <ul>
+<li>Whether to authorize users</li>
+<li>Page size of tables and indexes</li>
+<li>Where and whether to create an error log</li>
+<li>Which databases in the system to boot</li>
+</ul></p>
+</conbody>
+</concept>

Propchange: db/derby/docs/trunk/src/devguide/cdevsetprop11108.dita
------------------------------------------------------------------------------
    svn:eol-style = native

Added: db/derby/docs/trunk/src/devguide/cdevsetprop11561.dita
URL: http://svn.apache.org/viewvc/db/derby/docs/trunk/src/devguide/cdevsetprop11561.dita?rev=745679&view=auto
==============================================================================
--- db/derby/docs/trunk/src/devguide/cdevsetprop11561.dita (added)
+++ db/derby/docs/trunk/src/devguide/cdevsetprop11561.dita Wed Feb 18 22:39:19 2009
@@ -0,0 +1,81 @@
+<?xml version="1.0" encoding="utf-8"?>
+<!-- 
+Licensed to the Apache Software Foundation (ASF) under one or more
+contributor license agreements.  See the NOTICE file distributed with
+this work for additional information regarding copyright ownership.
+The ASF licenses this file to You 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 "-//OASIS//DTD DITA Concept//EN" "../dtd/concept.dtd">
+<concept xml:lang="en-us" id="cdevsetprop11561">
+<title>Changing the system-wide properties programmatically</title>
+<prolog><metadata>
+<keywords>
+<indexterm>system properties<indexterm>setting on command line</indexterm></indexterm>
+<indexterm>properties<indexterm>setting using a Properties object</indexterm></indexterm>
+<indexterm>system properties<indexterm>setting in a Properties object</indexterm></indexterm>
+</keywords>
+</metadata>
+</prolog>
+<conbody>
+<p>You can set properties programmatically -- either in application code before
+booting the <ph conref="../conrefs.dita#prod/productshortname"></ph> driver or
+as a command-line option to the <tm tmclass="special"
+tmowner="Sun Microsystems, Inc." tmtype="tm" trademark="Java">Java</tm> Virtual
+Machine (JVM) when booting the application that starts up
+<ph conref="../conrefs.dita#prod/productshortname"></ph>. When you set
+properties programmatically, these properties persist only for the duration of
+the application. Properties set programmatically are not written to the
+<i>derby.properties</i> file or made persistent in any other way by
+<ph conref="../conrefs.dita#prod/productshortname"></ph>.</p>
+<note>Setting properties programmatically works only for the application that
+starts up <ph conref="../conrefs.dita#prod/productshortname"></ph>; for example,
+for an application in an embedded environment or for the application server that
+starts up a server product. It does not work for client applications connecting
+to a server that is running.</note>
+<p>You can set properties programmatically in the following ways:</p>
+<ul>
+<li><xref href="cdevsetprop11561.dita#cdevsetprop11561/comparam"></xref></li>
+<li><xref href="cdevsetprop11561.dita#cdevsetprop11561/propobj"></xref></li>
+</ul>
+<section id="comparam"><title>As a parameter to the JVM command line</title>
+<p>You can set system-wide properties as parameters to the JVM command line when
+you start up the application or framework in which
+<ph conref="../conrefs.dita#prod/productshortname"></ph> is embedded.</p>
+<ul>
+<li><i>IBM Application Developer Kits</i>
+<p>With the IBM® SDK, you set JVM system properties by using a <i>-D</i> flag
+on the Java command line. For example:</p>
+<codeblock><b>java -Dderby.system.home=C:\home\<ph conref="../conrefs.dita#prod/productshortname"></ph>\ 
+    -Dderby.storage.pageSize=8192 JDBCTest</b></codeblock></li>
+</ul>
+<p>For other JVMs, see the JVM-specific documentation on setting system
+properties.</p>
+</section>
+<section id="propobj">
+<title>Using a Properties object within an application or statement</title>
+<p>In embedded mode, your application runs in the same JVM as
+<ph conref="../conrefs.dita#prod/productshortname"></ph>, so you can also set
+system properties within an application using a <i>Properties</i> object before
+loading the <ph conref="../conrefs.dita#prod/productshortname"></ph> JDBC
+driver. The following example sets <i>derby.system.home</i> on Windows.</p>
+<codeblock><b>Properties p = System.getProperties();
+p.put("derby.system.home", "C:\databases\sample");</b></codeblock>
+<note>If you pass in a <i>Properties</i> object as an argument to the
+<i>DriverManager.getConnection</i> call when connecting to a database, those
+properties are used as database connection URL attributes, not as properties of
+the type discussed in this book. For more information, see
+"java.sql.DriverManager.getConnection method" and "Setting attributes for the
+database connection URL" in the <ph conref="../conrefs.dita#pub/citref"></ph>.
+</note>
+</section>
+</conbody></concept>

Propchange: db/derby/docs/trunk/src/devguide/cdevsetprop11561.dita
------------------------------------------------------------------------------
    svn:eol-style = native

Added: db/derby/docs/trunk/src/devguide/cdevsetprop12821.dita
URL: http://svn.apache.org/viewvc/db/derby/docs/trunk/src/devguide/cdevsetprop12821.dita?rev=745679&view=auto
==============================================================================
--- db/derby/docs/trunk/src/devguide/cdevsetprop12821.dita (added)
+++ db/derby/docs/trunk/src/devguide/cdevsetprop12821.dita Wed Feb 18 22:39:19 2009
@@ -0,0 +1,48 @@
+<?xml version="1.0" encoding="utf-8"?>
+<!-- 
+Licensed to the Apache Software Foundation (ASF) under one or more
+contributor license agreements.  See the NOTICE file distributed with
+this work for additional information regarding copyright ownership.
+The ASF licenses this file to You 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 "-//OASIS//DTD DITA Concept//EN" "../dtd/concept.dtd">
+<concept xml:lang="en-us" id="cdevsetprop12821">
+<title>Setting database-wide properties</title>
+<prolog><metadata>
+<keywords>
+<indexterm>database-wide properties<indexterm>setting</indexterm></indexterm>
+<indexterm>SYSCS_SET_DATABASE_PROPERTY</indexterm>
+<indexterm>database-wide properties<indexterm>verifying value
+of</indexterm></indexterm>
+<indexterm>SYSCS_GET_DATABASE_PROPERTY</indexterm>
+</keywords>
+</metadata>
+</prolog>
+<conbody>
+<p>Database-wide properties, which affect a single database, are stored within
+the database itself. This allows different databases within a single <ph conref="../conrefs.dita#prod/productshortname"></ph> system
+to have different properties and ensures that the properties are correctly
+set when a database is moved away from its original system or copied.  
+<note>You should use database-wide properties wherever possible for ease
+of deployment.</note></p>
+<p>You set and verify database-wide properties using system procedures within SQL statements.</p>
+<p>To set a property, you connect to the database, create a statement, and
+then use the <codeph>SYSCS_UTIL.SYSCS_SET_DATABASE_PROPERTY</codeph> procedure,
+passing the name of the property and the value.</p>
+<p>To check the current value of a property, you connect to the database,
+create a statement, and then use the <codeph>SYSCS_UTIL.SYSCS_GET_DATABASE_PROPERTY</codeph> function, passing in the name of the property.  </p>
+<p>If you specify an invalid value, <ph conref="../conrefs.dita#prod/productshortname"></ph> uses the default value for
+the property.</p>
+<p>See the <cite><ph conref="../conrefs.dita#pub/citref"></ph></cite> for more information on how to use these system
+functions and procedures.</p>
+</conbody></concept>

Propchange: db/derby/docs/trunk/src/devguide/cdevsetprop12821.dita
------------------------------------------------------------------------------
    svn:eol-style = native

Added: db/derby/docs/trunk/src/devguide/cdevsetprop13074.dita
URL: http://svn.apache.org/viewvc/db/derby/docs/trunk/src/devguide/cdevsetprop13074.dita?rev=745679&view=auto
==============================================================================
--- db/derby/docs/trunk/src/devguide/cdevsetprop13074.dita (added)
+++ db/derby/docs/trunk/src/devguide/cdevsetprop13074.dita Wed Feb 18 22:39:19 2009
@@ -0,0 +1,57 @@
+<?xml version="1.0" encoding="utf-8"?>
+<!DOCTYPE concept PUBLIC "-//OASIS//DTD DITA Concept//EN"
+ "../dtd/concept.dtd">
+<!-- 
+Licensed to the Apache Software Foundation (ASF) under one or more
+contributor license agreements.  See the NOTICE file distributed with
+this work for additional information regarding copyright ownership.
+The ASF licenses this file to You 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="cdevsetprop13074" xml:lang="en-us">
+<title>Changing the system-wide properties by using the derby.properties file</title>
+<prolog><metadata>
+<keywords><indexterm>derby.properties file</indexterm>
+<indexterm>system-wide properties<indexterm>setting</indexterm></indexterm>
+<indexterm>derby.system.home<indexterm>determining location of derby.properties</indexterm></indexterm>
+</keywords></metadata></prolog>
+<conbody>
+<p>You can set persistent system-wide properties in a text file called
+<i>derby.properties</i>, which must be placed in the directory specified by the
+<i>derby.system.home</i> property. There should be one <i>derby.properties</i>
+file per system, not per database. The file must be created in the system
+directory. In a client/server environment, that directory is on the server.
+(For more information about a
+<ph conref="../conrefs.dita#prod/productshortname"></ph> system and the system
+directory, see <xref href="cdevdvlp27610.dita#cdevdvlp27610"></xref>.)</p>
+<p><ph conref="../conrefs.dita#prod/productshortname"></ph> does <i>not</i>:
+<ul>
+<li>Provide this file</li>
+<li>Automatically create this file for you</li>
+<li>Automatically write any properties or values to this file</li>
+</ul></p>
+<p>Instead, you must create, write, and edit this file yourself.</p>
+<p>The file should be in the format created by the
+<i>java.util.Properties.save</i> method.</p>
+<p>The following is the text of a sample properties file:
+<codeblock><b>derby.infolog.append=true 
+derby.storage.pageSize=8192
+derby.storage.pageReservedSpace=60</b></codeblock></p>
+<p>Properties set this way are persistent for the system until changed, until
+the file is removed from the system, or until the system is booted in some
+other directory (in which case
+<ph conref="../conrefs.dita#prod/productshortname"></ph> would be looking for
+<i>derby.properties</i> in that new directory). If a database is removed from a
+system, system-wide properties do not "travel" with the database unless
+explicitly set again.</p>
+</conbody>
+</concept>

Propchange: db/derby/docs/trunk/src/devguide/cdevsetprop13074.dita
------------------------------------------------------------------------------
    svn:eol-style = native

Added: db/derby/docs/trunk/src/devguide/cdevsetprop16827.dita
URL: http://svn.apache.org/viewvc/db/derby/docs/trunk/src/devguide/cdevsetprop16827.dita?rev=745679&view=auto
==============================================================================
--- db/derby/docs/trunk/src/devguide/cdevsetprop16827.dita (added)
+++ db/derby/docs/trunk/src/devguide/cdevsetprop16827.dita Wed Feb 18 22:39:19 2009
@@ -0,0 +1,32 @@
+<?xml version="1.0" encoding="utf-8"?>
+<!-- 
+Licensed to the Apache Software Foundation (ASF) under one or more
+contributor license agreements.  See the NOTICE file distributed with
+this work for additional information regarding copyright ownership.
+The ASF licenses this file to You 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 "-//OASIS//DTD DITA Concept//EN" "../dtd/concept.dtd">
+<concept xml:lang="en-us" id="cdevsetprop16827">
+<title>Setting system-wide properties</title>
+<prolog><metadata>
+<keywords>
+<indexterm>derby.properties file</indexterm>
+<indexterm>properties<indexterm>system-wide scope</indexterm></indexterm>
+</keywords>
+</metadata>
+</prolog>
+<conbody>
+<p>You can set system-wide properties programmatically (as a command-line
+option to the JVM when starting the application or within application code)
+or in the text file <i>derby.properties</i>.</p>
+</conbody></concept>

Propchange: db/derby/docs/trunk/src/devguide/cdevsetprop16827.dita
------------------------------------------------------------------------------
    svn:eol-style = native

Added: db/derby/docs/trunk/src/devguide/cdevsetprop23308.dita
URL: http://svn.apache.org/viewvc/db/derby/docs/trunk/src/devguide/cdevsetprop23308.dita?rev=745679&view=auto
==============================================================================
--- db/derby/docs/trunk/src/devguide/cdevsetprop23308.dita (added)
+++ db/derby/docs/trunk/src/devguide/cdevsetprop23308.dita Wed Feb 18 22:39:19 2009
@@ -0,0 +1,38 @@
+<?xml version="1.0" encoding="utf-8"?>
+<!-- 
+Licensed to the Apache Software Foundation (ASF) under one or more
+contributor license agreements.  See the NOTICE file distributed with
+this work for additional information regarding copyright ownership.
+The ASF licenses this file to You 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 "-//OASIS//DTD DITA Concept//EN" "../dtd/concept.dtd">
+<concept xml:lang="en-us" id="cdevsetprop23308">
+<title>Precedence of properties</title>
+<prolog><metadata>
+<keywords>
+<indexterm>Properties<indexterm>precedence of</indexterm></indexterm>
+</keywords>
+</metadata>
+</prolog>
+<conbody>
+<p>The search order for properties is:  
+<ol>
+<li>System-wide properties set programmatically (as a command-line option
+to the JVM when starting the application or within application code)</li>
+<li>Database-wide properties</li>
+<li>System-wide properties set in the <i>derby.properties</i> file</li>
+</ol></p>
+<p>This means, for example, that system-wide properties set programmatically
+override database-wide properties and system-wide properties set in the <i>derby.properties</i> file, and that database-wide properties
+override system-wide properties set in the <i>derby.properties</i> file.</p>
+</conbody></concept>

Propchange: db/derby/docs/trunk/src/devguide/cdevsetprop23308.dita
------------------------------------------------------------------------------
    svn:eol-style = native

Added: db/derby/docs/trunk/src/devguide/cdevsetprop24222.dita
URL: http://svn.apache.org/viewvc/db/derby/docs/trunk/src/devguide/cdevsetprop24222.dita?rev=745679&view=auto
==============================================================================
--- db/derby/docs/trunk/src/devguide/cdevsetprop24222.dita (added)
+++ db/derby/docs/trunk/src/devguide/cdevsetprop24222.dita Wed Feb 18 22:39:19 2009
@@ -0,0 +1,30 @@
+<?xml version="1.0" encoding="utf-8"?>
+<!DOCTYPE concept PUBLIC "-//OASIS//DTD DITA Concept//EN"
+ "../dtd/concept.dtd">
+<!-- 
+Licensed to the Apache Software Foundation (ASF) under one or more
+contributor license agreements.  See the NOTICE file distributed with
+this work for additional information regarding copyright ownership.
+The ASF licenses this file to You 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="cdevsetprop24222" xml:lang="en-us">
+<title>Setting Derby properties</title>
+<prolog><metadata>
+<keywords><indexterm>Configuring Derby</indexterm>
+<indexterm>Derby properties<indexterm>setting</indexterm></indexterm>
+</keywords>
+</metadata></prolog>
+<conbody>
+<p>This section covers the different ways of setting properties.</p>
+</conbody>
+</concept>

Propchange: db/derby/docs/trunk/src/devguide/cdevsetprop24222.dita
------------------------------------------------------------------------------
    svn:eol-style = native

Added: db/derby/docs/trunk/src/devguide/cdevsetprop24843.dita
URL: http://svn.apache.org/viewvc/db/derby/docs/trunk/src/devguide/cdevsetprop24843.dita?rev=745679&view=auto
==============================================================================
--- db/derby/docs/trunk/src/devguide/cdevsetprop24843.dita (added)
+++ db/derby/docs/trunk/src/devguide/cdevsetprop24843.dita Wed Feb 18 22:39:19 2009
@@ -0,0 +1,61 @@
+<?xml version="1.0" encoding="utf-8"?>
+<!-- 
+Licensed to the Apache Software Foundation (ASF) under one or more
+contributor license agreements.  See the NOTICE file distributed with
+this work for additional information regarding copyright ownership.
+The ASF licenses this file to You 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 "-//OASIS//DTD DITA Concept//EN" "../dtd/concept.dtd">
+<concept xml:lang="en-us" id="cdevsetprop24843">
+<title>Setting properties in a client/server environment</title>
+<prolog><metadata>
+<keywords>
+<indexterm>properties<indexterm>in client/server mode</indexterm></indexterm>
+</keywords>
+</metadata>
+</prolog>
+<conbody>
+<p>In a client/server environment, you must set the system properties for
+the <i>server</i>'s system. That means when you are using
+the <i>derby.properties</i> file, the file exists in the <i>server</i>'s <i>derby.system.home</i> directory.
+Client applications can set database-wide because they are set via SQL statements.
+Client applications can set dynamic system-wide properties in an SQL statement,
+as shown in the example in
+<xref href="cdevsetprop11561.dita#cdevsetprop11561/propobj"></xref>.
+ 
+<table frame="all">
+<title>Summary of ways to set properties</title>
+<tgroup cols="2" colsep="1" rowsep="1">
+<colspec colnum="1" colname="1" colwidth="37*"/>
+<colspec colnum="2" colname="2" colwidth="63*"/>
+<thead>
+<row>
+<entry colname="1">Type of property</entry>
+<entry colname="2">How you set it</entry></row>
+</thead>
+<tbody>
+<row>
+<entry colname="1">System-wide</entry>
+<entry colname="2">
+<ul>
+<li>In <i>derby.properties</i></li>
+<li>Programmatically (as a command-line option to the JVM when starting the
+application or within application code)</li>
+</ul></entry></row>
+<row>
+<entry colname="1">Database-wide</entry>
+<entry colname="2">Using system procedures and functions in an SQL statement </entry></row>
+</tbody>
+</tgroup>
+</table></p>
+</conbody></concept>

Propchange: db/derby/docs/trunk/src/devguide/cdevsetprop24843.dita
------------------------------------------------------------------------------
    svn:eol-style = native

Added: db/derby/docs/trunk/src/devguide/cdevsetprop32443.dita
URL: http://svn.apache.org/viewvc/db/derby/docs/trunk/src/devguide/cdevsetprop32443.dita?rev=745679&view=auto
==============================================================================
--- db/derby/docs/trunk/src/devguide/cdevsetprop32443.dita (added)
+++ db/derby/docs/trunk/src/devguide/cdevsetprop32443.dita Wed Feb 18 22:39:19 2009
@@ -0,0 +1,87 @@
+<?xml version="1.0" encoding="utf-8"?>
+<!-- 
+Licensed to the Apache Software Foundation (ASF) under one or more
+contributor license agreements.  See the NOTICE file distributed with
+this work for additional information regarding copyright ownership.
+The ASF licenses this file to You 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 "-//OASIS//DTD DITA Concept//EN" "../dtd/concept.dtd">
+<concept xml:lang="en-us" id="cdevsetprop32443">
+<title>Properties case study</title>
+<prolog><metadata>
+<keywords>
+<indexterm>properties<indexterm>implications of having various ways to set</indexterm></indexterm>
+</keywords>
+</metadata>
+</prolog>
+<conbody>
+<p><ph conref="../conrefs.dita#prod/productshortname"></ph> allows you a lot of
+freedom in configuring your system. This freedom can be confusing if you do not
+understand how properties work. You also have the option of not setting any
+properties and instead using the
+<ph conref="../conrefs.dita#prod/productshortname"></ph> defaults, which are
+tuned for a single-user embedded system.</p>
+<p>Imagine the following scenario of an embedded environment:</p>
+<p>Your system has a <i>derby.properties</i> file, a text file in the system
+directory, which you have created and named <i>system_directory</i>. Your
+databases have also been created in this directory. The properties file sets
+the following property:</p>
+<codeblock><b>derby.storage.pageSize=8192</b></codeblock>
+<p>You start up your application, being sure to set the <i>derby.system.home</i>
+property appropriately:
+<codeblock><b>java -Dderby.system.home=c:\system_directory MyApp</b></codeblock>
+</p>
+<p>You then create a new table:
+<codeblock><b>CREATE TABLE table1 (a INT, b VARCHAR(10))</b></codeblock></p>
+<p><ph conref="../conrefs.dita#prod/productshortname"></ph> takes the page size
+of 8192 from the system-wide properties set in the <i>derby.properties</i> file,
+since the property has not been set any other way.</p>
+<p>You shut down and then restart your application, setting the value of
+<i>derby.storage.pageSize</i> to 4096 programmatically, as a parameter to the
+JVM command line:
+<codeblock><b>java -Dderby.system.home=c:\system_directory 
+    -Dderby.storage.pageSize=4096 MyApp
+CREATE TABLE anothertable (a INT, b VARCHAR(10))</b></codeblock>
+The page size for the <i>anothertable</i> table will be 4096 bytes.</p>
+<p>You establish a connection to the database and set the value of the page
+size for all new tables to 32768 as a database-wide property:
+<codeblock><b>CallableStatement cs = 
+  conn.prepareCall("CALL SYSCS_UTIL.SYSCS_SET_DATABASE_PROPERTY(?, ?)"); 
+cs.setString(1, "derby.storage.pageSize"); 
+cs.setString(2, "32768"); 
+cs.execute(); 
+cs.close(); 
+</b></codeblock></p>
+<p>You then create a new table that automatically inherits the page size set
+by the property:
+<codeblock><b>CREATE TABLE table2 (a INT, b VARCHAR(10))</b></codeblock>
+The page size for the <i>table2</i> table is 32768 bytes.</p>
+<p>You shut down the application, then restart, this time forgetting to set
+the system-wide property programmatically (as a command-line option to the
+JVM):
+<codeblock><b>java -Dderby.system.home=c:\system_directory MyApp</b></codeblock>
+</p>
+<p>You then create another table:
+<codeblock><b>CREATE TABLE table4 (a INT, b VARCHAR(10))</b></codeblock></p>
+<p><ph conref="../conrefs.dita#prod/productshortname"></ph> uses the persistent
+database-wide property of 32768 for this table, since the database-wide property
+set in the previous session is persistent and overrides the system-wide property
+set in the <i>derby.properties</i> file.</p>
+<p>What you have is a situation in which three different tables each get a
+different page size, even though the <i>derby.properties</i> file remained
+constant.</p>
+<p>If you remove the <i>derby.properties</i> file from the system or remove the
+database from its current location (forgetting to move the file with it), you
+could get yet another value for a new table.</p>
+<p>To avoid this situation, be consistent in the way you set properties.</p>
+</conbody></concept>

Propchange: db/derby/docs/trunk/src/devguide/cdevsetprop32443.dita
------------------------------------------------------------------------------
    svn:eol-style = native

Added: db/derby/docs/trunk/src/devguide/cdevsetprop34818.dita
URL: http://svn.apache.org/viewvc/db/derby/docs/trunk/src/devguide/cdevsetprop34818.dita?rev=745679&view=auto
==============================================================================
--- db/derby/docs/trunk/src/devguide/cdevsetprop34818.dita (added)
+++ db/derby/docs/trunk/src/devguide/cdevsetprop34818.dita Wed Feb 18 22:39:19 2009
@@ -0,0 +1,29 @@
+<?xml version="1.0" encoding="utf-8"?>
+<!-- 
+Licensed to the Apache Software Foundation (ASF) under one or more
+contributor license agreements.  See the NOTICE file distributed with
+this work for additional information regarding copyright ownership.
+The ASF licenses this file to You 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 "-//OASIS//DTD DITA Concept//EN" "../dtd/concept.dtd">
+<concept xml:lang="en-us" id="cdevsetprop34818">
+<title>Working with <ph conref="../conrefs.dita#prod/productshortname"></ph> properties</title>
+<prolog>
+</prolog>
+<conbody>
+<p>This section describes how to use
+<ph conref="../conrefs.dita#prod/productshortname"></ph> properties. For
+details on specific properties, see the
+"<ph conref="../conrefs.dita#prod/productshortname"></ph> properties" section of
+the <ph conref="../conrefs.dita#pub/citref"></ph>.</p>
+</conbody></concept>

Propchange: db/derby/docs/trunk/src/devguide/cdevsetprop34818.dita
------------------------------------------------------------------------------
    svn:eol-style = native

Added: db/derby/docs/trunk/src/devguide/cdevsetprop44147.dita
URL: http://svn.apache.org/viewvc/db/derby/docs/trunk/src/devguide/cdevsetprop44147.dita?rev=745679&view=auto
==============================================================================
--- db/derby/docs/trunk/src/devguide/cdevsetprop44147.dita (added)
+++ db/derby/docs/trunk/src/devguide/cdevsetprop44147.dita Wed Feb 18 22:39:19 2009
@@ -0,0 +1,36 @@
+<?xml version="1.0" encoding="utf-8"?>
+<!-- 
+Licensed to the Apache Software Foundation (ASF) under one or more
+contributor license agreements.  See the NOTICE file distributed with
+this work for additional information regarding copyright ownership.
+The ASF licenses this file to You 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 "-//OASIS//DTD DITA Concept//EN" "../dtd/concept.dtd">
+<concept xml:lang="en-us" id="cdevsetprop44147">
+<title>Making dynamic or static changes to properties</title>
+<prolog>
+</prolog>
+<conbody>
+<note>Properties set in the <i>derby.properties</i> file and on the command line of the application that boots <ph conref="../conrefs.dita#prod/productshortname"></ph> are <i>always</i> static, because <ph conref="../conrefs.dita#prod/productshortname"></ph> reads this file and
+those parameters only at startup.</note>
+<p>Only properties set in the following ways have the potential to be dynamic:
+ 
+<ul>
+<li>As database-wide properties</li>
+<li>As system-wide properties via a <i>Properties</i> object
+in the application in which the <ph conref="../conrefs.dita#prod/productshortname"></ph> engine is embedded</li>
+</ul></p>
+<p>See the "<ph conref="../conrefs.dita#prod/productshortname"></ph> properties"
+section of the <ph conref="../conrefs.dita#pub/citref"></ph> for information
+about specific properties.</p>
+</conbody></concept>

Propchange: db/derby/docs/trunk/src/devguide/cdevsetprop44147.dita
------------------------------------------------------------------------------
    svn:eol-style = native

Added: db/derby/docs/trunk/src/devguide/cdevsetprop824451.dita
URL: http://svn.apache.org/viewvc/db/derby/docs/trunk/src/devguide/cdevsetprop824451.dita?rev=745679&view=auto
==============================================================================
--- db/derby/docs/trunk/src/devguide/cdevsetprop824451.dita (added)
+++ db/derby/docs/trunk/src/devguide/cdevsetprop824451.dita Wed Feb 18 22:39:19 2009
@@ -0,0 +1,51 @@
+<?xml version="1.0" encoding="utf-8"?>
+<!-- 
+Licensed to the Apache Software Foundation (ASF) under one or more
+contributor license agreements.  See the NOTICE file distributed with
+this work for additional information regarding copyright ownership.
+The ASF licenses this file to You 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 "-//OASIS//DTD DITA Concept//EN" "../dtd/concept.dtd">
+<concept xml:lang="en-us" id="cdevsetprop824451">
+<title>Scope of properties</title>
+<prolog><metadata>
+<keywords>
+<indexterm>properties<indexterm>scope of</indexterm></indexterm>
+<indexterm>properties<indexterm>system-wide scope</indexterm></indexterm>
+<indexterm>properties<indexterm>database-wide scope</indexterm></indexterm>
+<indexterm>properties<indexterm>conglomerate-specific scope</indexterm></indexterm>
+</keywords>
+</metadata>
+</prolog>
+<conbody>
+<p>You use properties to configure a
+<ph conref="../conrefs.dita#prod/productshortname"></ph> system, database, or
+conglomerate.
+<ul>
+<li><i>system-wide</i>  
+<p>Most properties can be set on a <i>system-wide</i> basis; that is, you set a
+property for the entire system and all its databases and conglomerates, if this
+is applicable. Some properties, such as error handling and automatic booting,
+can be configured only in this way, since they apply to the entire system. (For
+information about the <ph conref="../conrefs.dita#prod/productshortname"></ph>
+system, see <xref href="cdevdvlp27610.dita#cdevdvlp27610"></xref>.)</p>
+<p>When you change these properties, they affect any tables or indexes created
+<i>after</i> this change.</p></li>
+<li><i>database-wide</i>  
+<p>Some properties can also be set on a <i>database-wide</i> basis. That is, the
+property is true for the selected database only and not for the other databases
+in the system unless it is set individually within each of them.</p>
+<p>When you change these properties, they affect any tables or indexes created
+<i>after</i> this change.</p></li>
+</ul></p>
+</conbody></concept>

Propchange: db/derby/docs/trunk/src/devguide/cdevsetprop824451.dita
------------------------------------------------------------------------------
    svn:eol-style = native

Added: db/derby/docs/trunk/src/devguide/cdevsetprop824500.dita
URL: http://svn.apache.org/viewvc/db/derby/docs/trunk/src/devguide/cdevsetprop824500.dita?rev=745679&view=auto
==============================================================================
--- db/derby/docs/trunk/src/devguide/cdevsetprop824500.dita (added)
+++ db/derby/docs/trunk/src/devguide/cdevsetprop824500.dita Wed Feb 18 22:39:19 2009
@@ -0,0 +1,46 @@
+<?xml version="1.0" encoding="utf-8"?>
+<!-- 
+Licensed to the Apache Software Foundation (ASF) under one or more
+contributor license agreements.  See the NOTICE file distributed with
+this work for additional information regarding copyright ownership.
+The ASF licenses this file to You 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 "-//OASIS//DTD DITA Concept//EN" "../dtd/concept.dtd">
+<concept xml:lang="en-us" id="cdevsetprop824500">
+<title>Persistence of properties</title>
+<prolog><metadata>
+<keywords>
+<indexterm>Properties<indexterm>persistence of</indexterm></indexterm>
+</keywords>
+</metadata>
+</prolog>
+<conbody>
+<p>A database-wide property always has persistence. That is, its value is
+stored in the database. Typically, it is in effect until you explicitly change
+the property or until you set a system-wide property with precedence over
+database-wide properties (see <xref href="cdevsetprop23308.dita#cdevsetprop23308"/>).</p>
+<p>To disable or turn off a database-wide property setting, set its value to
+null. This has the effect of removing the property from the list of database
+properties and restoring the system property setting, if there is one (and if
+<i>derby.database.propertiesOnly</i> has not been set; see
+<xref href="cdevsetprop824533.dita#cdevsetprop824533"></xref>).</p>
+<p>A system-wide property might have persistence, depending on how you set
+it. If you set it programmatically, it persists only for the duration of the
+JVM of the application that set it. If you set it in the
+<i>derby.properties</i> file, a property persists until:</p>  
+<ul>
+<li>That value is changed and the system is rebooted</li>
+<li>The file is removed from the system and the system is rebooted</li>
+<li>The database is booted outside of that system</li>
+</ul>
+</conbody></concept>

Propchange: db/derby/docs/trunk/src/devguide/cdevsetprop824500.dita
------------------------------------------------------------------------------
    svn:eol-style = native

Added: db/derby/docs/trunk/src/devguide/cdevsetprop824533.dita
URL: http://svn.apache.org/viewvc/db/derby/docs/trunk/src/devguide/cdevsetprop824533.dita?rev=745679&view=auto
==============================================================================
--- db/derby/docs/trunk/src/devguide/cdevsetprop824533.dita (added)
+++ db/derby/docs/trunk/src/devguide/cdevsetprop824533.dita Wed Feb 18 22:39:19 2009
@@ -0,0 +1,40 @@
+<?xml version="1.0" encoding="utf-8"?>
+<!-- 
+Licensed to the Apache Software Foundation (ASF) under one or more
+contributor license agreements.  See the NOTICE file distributed with
+this work for additional information regarding copyright ownership.
+The ASF licenses this file to You 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 "-//OASIS//DTD DITA Concept//EN" "../dtd/concept.dtd">
+<concept xml:lang="en-us" id="cdevsetprop824533">
+<title>Protection of database-wide properties</title>
+<prolog><metadata>
+<keywords>
+<indexterm>derby.database.propertiesOnly</indexterm>
+<indexterm>Database-wide properties<indexterm>protecting for
+embedded environment</indexterm></indexterm>
+</keywords>
+</metadata>
+</prolog>
+<conbody>
+<p>There is one important exception to the search order for properties described
+above: When you set the <i>derby.database.propertiesOnly</i> property
+to <i>true</i>, database-wide properties cannot be overridden
+by system-wide properties.</p>
+<p>This property ensures that a database's environment cannot be modified
+by the environment in which it is booted. Any application running in an embedded
+environment can set this property to <codeph>true</codeph> for security reasons.</p>
+<p>See the "<ph conref="../conrefs.dita#prod/productshortname"></ph> properties"
+section of the <ph conref="../conrefs.dita#pub/citref"></ph> for details on the
+<i>derby.database.propertiesOnly</i> property.</p>
+</conbody></concept>

Propchange: db/derby/docs/trunk/src/devguide/cdevsetprop824533.dita
------------------------------------------------------------------------------
    svn:eol-style = native

Added: db/derby/docs/trunk/src/devguide/cdevsetprop824615.dita
URL: http://svn.apache.org/viewvc/db/derby/docs/trunk/src/devguide/cdevsetprop824615.dita?rev=745679&view=auto
==============================================================================
--- db/derby/docs/trunk/src/devguide/cdevsetprop824615.dita (added)
+++ db/derby/docs/trunk/src/devguide/cdevsetprop824615.dita Wed Feb 18 22:39:19 2009
@@ -0,0 +1,38 @@
+<?xml version="1.0" encoding="utf-8"?>
+<!-- 
+Licensed to the Apache Software Foundation (ASF) under one or more
+contributor license agreements.  See the NOTICE file distributed with
+this work for additional information regarding copyright ownership.
+The ASF licenses this file to You 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 "-//OASIS//DTD DITA Concept//EN" "../dtd/concept.dtd">
+<concept xml:lang="en-us" id="cdevsetprop824615">
+<title>Dynamic versus static properties</title>
+<prolog><metadata>
+<keywords>
+<indexterm>Static properties</indexterm>
+<indexterm>Dynamic properties</indexterm>
+<indexterm>Properties<indexterm>dynamic versus static</indexterm></indexterm>
+</keywords>
+</metadata>
+</prolog>
+<conbody>
+<p>Most properties are dynamic; that means you can set them while <ph conref="../conrefs.dita#prod/productshortname"></ph> is
+running, and their values change without requiring a reboot of <ph conref="../conrefs.dita#prod/productshortname"></ph>.
+In some cases, this change takes place immediately; in some cases, it takes
+place at the next connection.</p>
+<p>Some properties are static, which means changes to their values will not
+take effect while <ph conref="../conrefs.dita#prod/productshortname"></ph> is running. You must restart or set them before
+(or while) starting <ph conref="../conrefs.dita#prod/productshortname"></ph>.</p>
+<p>For more information, see <xref href="cdevsetprop44147.dita#cdevsetprop44147"/>.</p>
+</conbody></concept>

Propchange: db/derby/docs/trunk/src/devguide/cdevsetprop824615.dita
------------------------------------------------------------------------------
    svn:eol-style = native

Added: db/derby/docs/trunk/src/devguide/cdevsetprop824983.dita
URL: http://svn.apache.org/viewvc/db/derby/docs/trunk/src/devguide/cdevsetprop824983.dita?rev=745679&view=auto
==============================================================================
--- db/derby/docs/trunk/src/devguide/cdevsetprop824983.dita (added)
+++ db/derby/docs/trunk/src/devguide/cdevsetprop824983.dita Wed Feb 18 22:39:19 2009
@@ -0,0 +1,47 @@
+<?xml version="1.0" encoding="utf-8"?>
+<!-- 
+Licensed to the Apache Software Foundation (ASF) under one or more
+contributor license agreements.  See the NOTICE file distributed with
+this work for additional information regarding copyright ownership.
+The ASF licenses this file to You 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 "-//OASIS//DTD DITA Concept//EN" "../dtd/concept.dtd">
+<concept xml:lang="en-us" id="cdevsetprop824983">
+<title>Verifying system properties</title>
+<prolog>
+</prolog>
+<conbody>
+<p>You can find out the value of a system property if you set it
+programmatically. You cannot find out the value of a system property if you set
+it in the <i>derby.properties</i> file.</p>
+<p>For example, if you set the value of the
+<codeph>derby.storage.pageSize</codeph> system-wide property in your program or
+on the command line, the following code will retrieve its value from the System
+Properties object:
+<codeblock><b>Properties sprops = System.getProperties();
+System.out.println("derby.storage.pageSize value: "
++ sprops.getProperty("derby.storage.pageSize"));
+</b></codeblock></p>
+<p>You can also use Java Management Extensions (JMX) technology to obtain
+system information, including some settings that correspond to system
+properties. For details, visit the wiki page
+<xref format="html" href="http://wiki.apache.org/db-derby/DerbyJMX"
+scope="external">http://wiki.apache.org/db-derby/DerbyJMX</xref>
+and refer to the API documentation for the packages
+<codeph>org.apache.derby.mbeans</codeph> and
+<codeph>org.apache.derby.mbeans.drda</codeph>. For information on JMX
+technology, see 
+<xref format="html" href="http://java.sun.com/javase/technologies/core/mntr-mgmt/javamanagement/" 
+scope="external">http://java.sun.com/javase/technologies/core/mntr-mgmt/javamanagement/</xref>.
+</p>
+</conbody></concept>

Propchange: db/derby/docs/trunk/src/devguide/cdevsetprop824983.dita
------------------------------------------------------------------------------
    svn:eol-style = native

Modified: db/derby/docs/trunk/src/devguide/derbydev.ditamap
URL: http://svn.apache.org/viewvc/db/derby/docs/trunk/src/devguide/derbydev.ditamap?rev=745679&r1=745678&r2=745679&view=diff
==============================================================================
--- db/derby/docs/trunk/src/devguide/derbydev.ditamap (original)
+++ db/derby/docs/trunk/src/devguide/derbydev.ditamap Wed Feb 18 22:39:19 2009
@@ -1793,6 +1793,20 @@
 <topicref href="cdevdgpref23947.dita" navtitle="How this guide is organized">
 </topicref>
 </topicref>
+<topicref href="cdevstart19524.dita" navtitle="After installing">
+<topicref href="cdevstart16043.dita" navtitle="The installation directory">
+<topicref href="cdevstart813142.dita" navtitle="Batch files and shell scripts">
+</topicref>
+</topicref>
+<topicref href="cdevstart18978.dita" navtitle="Derby and JVMs"></topicref>
+<topicref href="cdevstart98282.dita" navtitle="Derby libraries and classpath">
+</topicref>
+<topicref href="cdevstart41260.dita" navtitle="UNIX-specific issues">
+<topicref href="cdevstart39409.dita" navtitle="Configuring file descriptors">
+</topicref>
+<topicref href="cdevstart813545.dita" navtitle="Scripts"></topicref>
+</topicref>
+</topicref>
 <topicref href="cdevupgrades.dita" navtitle="Upgrades">
 <topicref href="tdevpreupgrade.dita" navtitle="Preparing to upgrade"></topicref>
 <topicref href="tdevupgradedb.dita" navtitle="Upgrading a database"></topicref>
@@ -1868,19 +1882,35 @@
 </topicref>
 </topicref>
 </topicref>
+<topicref collection-type="family" href="cdevsetprop34818.dita" navtitle="Working with Derby properties">
+<topicref collection-type="family" href="cdevsetprop11108.dita" navtitle="Properties overview">
+<topicref href="cdevsetprop824451.dita" navtitle="Scope of properties"></topicref>
+<topicref href="cdevsetprop824500.dita" navtitle="Persistence of properties">
 </topicref>
-<topicref href="cdevstart19524.dita" navtitle="After installing">
-<topicref href="cdevstart16043.dita" navtitle="The installation directory">
-<topicref href="cdevstart813142.dita" navtitle="Batch files and shell scripts">
+<topicref collection-type="family" href="cdevsetprop23308.dita" navtitle="Precedence of properties">
+<topicref href="cdevsetprop824533.dita" navtitle="Protection of database-wide properties">
 </topicref>
 </topicref>
-<topicref href="cdevstart18978.dita" navtitle="Derby and JVMs"></topicref>
-<topicref href="cdevstart98282.dita" navtitle="Derby libraries and classpath">
+<topicref href="cdevsetprop824615.dita" navtitle="Dynamic versus static properties">
 </topicref>
-<topicref href="cdevstart41260.dita" navtitle="UNIX-specific issues">
-<topicref href="cdevstart39409.dita" navtitle="Configuring file descriptors">
 </topicref>
-<topicref href="cdevstart813545.dita" navtitle="Scripts"></topicref>
+<topicref collection-type="family" href="cdevsetprop24222.dita" navtitle="Setting Derby properties">
+<topicref collection-type="family" href="cdevsetprop16827.dita" navtitle="Setting system-wide properties">
+<topicref collection-type="family" href="cdevsetprop11561.dita" navtitle="Changing the system-wide properties programmatically">
+</topicref>
+<topicref href="cdevsetprop13074.dita" navtitle="Changing the system-wide properties by using the derby.properties file">
+</topicref>
+<topicref href="cdevsetprop824983.dita" navtitle="Verifying system properties">
+</topicref>
+</topicref>
+<topicref href="cdevsetprop12821.dita" navtitle="Setting database-wide properties">
+</topicref>
+<topicref href="cdevsetprop24843.dita" navtitle="Setting properties in a client/server environment">
+</topicref>
+<topicref href="cdevsetprop44147.dita" navtitle="Making dynamic or static changes to properties">
+</topicref>
+</topicref>
+<topicref href="cdevsetprop32443.dita" navtitle="Properties case study"></topicref>
 </topicref>
 </topicref>
 <topicref href="cdevdeploy32171.dita" navtitle="Deploying Derby applications">

Modified: db/derby/docs/trunk/src/devguide/tdevcsecure81850.dita
URL: http://svn.apache.org/viewvc/db/derby/docs/trunk/src/devguide/tdevcsecure81850.dita?rev=745679&r1=745678&r2=745679&view=diff
==============================================================================
--- db/derby/docs/trunk/src/devguide/tdevcsecure81850.dita (original)
+++ db/derby/docs/trunk/src/devguide/tdevcsecure81850.dita Wed Feb 18 22:39:19 2009
@@ -28,9 +28,10 @@
 <steps>
 <step><cmd>Encrypt the database when you create it.</cmd></step>
 <step><cmd>Configure all security features as database-level properties. 
-These properties are stored in the database (which is encrypted). See "Scope
-of properties" and "Database-wide properties" in <ph
-conref="../conrefs.dita#pub/cittuning"></ph> for more information.</cmd></step>
+These properties are stored in the database (which is encrypted). See
+<xref href="cdevsetprop824451.dita#cdevsetprop824451"></xref> and 
+<xref href="cdevsetprop12821.dita#cdevsetprop12821"></xref> for more
+information.</cmd></step>
 <step><cmd>Turn on protection for database-level properties so that they cannot
 be overridden by system properties by setting the <i>derby.database.propertiesOnly</i> property
 to TRUE. See the <ph conref="../conrefs.dita#pub/citref"></ph> for details

Modified: db/derby/docs/trunk/src/getstart/rgsdocs17307.dita
URL: http://svn.apache.org/viewvc/db/derby/docs/trunk/src/getstart/rgsdocs17307.dita?rev=745679&r1=745678&r2=745679&view=diff
==============================================================================
--- db/derby/docs/trunk/src/getstart/rgsdocs17307.dita (original)
+++ db/derby/docs/trunk/src/getstart/rgsdocs17307.dita Wed Feb 18 22:39:19 2009
@@ -42,7 +42,7 @@
 <dd>Describes the functionality and features of <ph conref="../conrefs.dita#prod/productshortname"></ph> common
 to all deployments, such as <ph conref="../conrefs.dita#prod/productshortname"></ph>'s
 JDBC and SQL specifics, deploying <ph conref="../conrefs.dita#prod/productshortname"></ph> applications,
-security, and other advanced features.</dd>
+working with properties, security, and other advanced features.</dd>
 </dlentry><dlentry>
 <dt><ph conref="../conrefs.dita#pub/citref"></ph></dt>
 <dd>Documents the implementation of the SQL language in <ph conref="../conrefs.dita#prod/productshortname"></ph>.
@@ -50,8 +50,7 @@
 keywords, system tables, properties, and <i>SQLExceptions</i> in <ph conref="../conrefs.dita#prod/productshortname"></ph>.</dd>
 </dlentry><dlentry>
 <dt><ph conref="../conrefs.dita#pub/cittuning"></ph></dt>
-<dd>Explains how to configure and tune <ph conref="../conrefs.dita#prod/productshortname"></ph> through
-properties. This guide also
+<dd>This guide
 offers performance tips, an in-depth discussion of performance, and information
 about the <ph conref="../conrefs.dita#prod/productshortname"></ph> optimizer.</dd>
 </dlentry><dlentry>

Modified: db/derby/docs/trunk/src/ref/crefproper22250.dita
URL: http://svn.apache.org/viewvc/db/derby/docs/trunk/src/ref/crefproper22250.dita?rev=745679&r1=745678&r2=745679&view=diff
==============================================================================
--- db/derby/docs/trunk/src/ref/crefproper22250.dita (original)
+++ db/derby/docs/trunk/src/ref/crefproper22250.dita Wed Feb 18 22:39:19 2009
@@ -34,16 +34,16 @@
 properties.</p>
 <p>For information on how to set
 <ph conref="../conrefs.dita#prod/productshortname"></ph> properties, see
-"Ways of setting Derby properties" in
-<ph conref="../conrefs.dita#pub/cittuning"></ph>.</p>
+"Setting Derby properties" in the
+<ph conref="../conrefs.dita#pub/citdevelop"></ph>.</p>
 <note>When
 setting properties that have boolean values, be sure to trim extra spaces
 around the word <i>true</i>. Extra spaces around the word <i>true</i> cause
 the property to be set to false, regardless of its previous setting.</note>
 <p>To disable or turn off a database-wide property setting, set its value to
 null. To determine the result of this action, recall that the search order for
-properties is as follows (as stated in "Precedence of properties" in 
-<ph conref="../conrefs.dita#pub/cittuning"></ph>).</p>
+properties is as follows (as stated in "Precedence of properties" in the
+<ph conref="../conrefs.dita#pub/citdevelop"></ph>).</p>
 <ol>
 <li>[*] System-wide properties set programmatically (as a command-line option
 to the JVM when starting the application or within application code)</li>

Modified: db/derby/docs/trunk/src/ref/crefproper51399.dita
URL: http://svn.apache.org/viewvc/db/derby/docs/trunk/src/ref/crefproper51399.dita?rev=745679&r1=745678&r2=745679&view=diff
==============================================================================
--- db/derby/docs/trunk/src/ref/crefproper51399.dita (original)
+++ db/derby/docs/trunk/src/ref/crefproper51399.dita Wed Feb 18 22:39:19 2009
@@ -18,7 +18,7 @@
 limitations under the License.
 -->
 <concept id="crefproper51399" xml:lang="en-us">
-<title>Scope of Derby properties</title>
+<title>Scope of <ph conref="../conrefs.dita#prod/productshortname"></ph> properties</title>
 <prolog></prolog>
 <conbody>
 <p>A property in <ph conref="../conrefs.dita#prod/productshortname"></ph> belongs
@@ -42,6 +42,6 @@
 parameters are probably easier for development.</note></li>
 </ul></p>
 <p>For more information about scopes, precedence, and persistence, see
-"Properties overview" in <ph conref="../conrefs.dita#pub/cittuning"></ph>.</p>
+"Properties overview" in the <ph conref="../conrefs.dita#pub/citdevelop"></ph>.</p>
 </conbody>
 </concept>

Modified: db/derby/docs/trunk/src/ref/refderby.ditamap
URL: http://svn.apache.org/viewvc/db/derby/docs/trunk/src/ref/refderby.ditamap?rev=745679&r1=745678&r2=745679&view=diff
==============================================================================
--- db/derby/docs/trunk/src/ref/refderby.ditamap (original)
+++ db/derby/docs/trunk/src/ref/refderby.ditamap Wed Feb 18 22:39:19 2009
@@ -656,7 +656,7 @@
 <topicref href="rrefattrib34183.dita" navtitle="Creating a connection without specifying attributes">
 </topicref>
 </topicref>
-<topicref collection-type="family" href="rrefproper32213.dita" navtitle="Derby properties">
+<topicref collection-type="family" href="rrefproper32213.dita" navtitle="Derby property reference">
 <topicref href="crefproper51399.dita" navtitle="Scope of Derby properties">
 </topicref>
 <topicref href="crefproperdynstat.dita" navtitle="Dynamic and static properties">

Modified: db/derby/docs/trunk/src/ref/rrefproper24390.dita
URL: http://svn.apache.org/viewvc/db/derby/docs/trunk/src/ref/rrefproper24390.dita?rev=745679&r1=745678&r2=745679&view=diff
==============================================================================
--- db/derby/docs/trunk/src/ref/rrefproper24390.dita (original)
+++ db/derby/docs/trunk/src/ref/rrefproper24390.dita Wed Feb 18 22:39:19 2009
@@ -29,8 +29,8 @@
 <p>When set to true, this property ensures that database-wide properties cannot
 be overridden by system-wide properties.</p>
 <p>When this property is set to false, or not set, database-wide properties can
-be overridden by system-wide properties (see "Precedence of properties" in
-<ph conref="../conrefs.dita#pub/cittuning"></ph>).</p>
+be overridden by system-wide properties (see "Precedence of properties" in the
+<ph conref="../conrefs.dita#pub/citdevelop"></ph>).</p>
 <p>This property ensures that a database's environment cannot be modified by the
 environment in which it is booted.</p>
 <p>This property can <i>never</i> be overridden by system properties.</p>

Modified: db/derby/docs/trunk/src/ref/rrefproper32213.dita
URL: http://svn.apache.org/viewvc/db/derby/docs/trunk/src/ref/rrefproper32213.dita?rev=745679&r1=745678&r2=745679&view=diff
==============================================================================
--- db/derby/docs/trunk/src/ref/rrefproper32213.dita (original)
+++ db/derby/docs/trunk/src/ref/rrefproper32213.dita Wed Feb 18 22:39:19 2009
@@ -17,8 +17,14 @@
 -->
 <!DOCTYPE reference PUBLIC "-//OASIS//DTD DITA Reference//EN" "../dtd/reference.dtd">
 <reference xml:lang="en-us" id="rrefproper32213">
-<title>Derby properties</title>
+<title><ph conref="../conrefs.dita#prod/productshortname"></ph> property reference</title>
 <prolog>
 </prolog>
-<refbody>
+<refbody><section>
+<p>This section provides reference information on
+<ph conref="../conrefs.dita#prod/productshortname"></ph> properties. For
+information on using these properties, see "Working with
+<ph conref="../conrefs.dita#prod/productshortname"></ph> properties" in the
+<ph conref="../conrefs.dita#pub/citdevelop"></ph>.
+</p></section>
 </refbody></reference>

Modified: db/derby/docs/trunk/src/ref/rrefsqlj31783.dita
URL: http://svn.apache.org/viewvc/db/derby/docs/trunk/src/ref/rrefsqlj31783.dita?rev=745679&r1=745678&r2=745679&view=diff
==============================================================================
--- db/derby/docs/trunk/src/ref/rrefsqlj31783.dita (original)
+++ db/derby/docs/trunk/src/ref/rrefsqlj31783.dita Wed Feb 18 22:39:19 2009
@@ -30,8 +30,8 @@
 Cursors are read-only by default. The FOR UPDATE clause specifies that the cursor should be updatable, and 
 enforces a check during compilation that
 the SELECT statement meets the requirements for an updatable <i>cursor</i>.
-For more information about updatability, see <xref href="rrefsqlj41360.dita#rrefsqlj41360/sqlj15384">Requirements
-for Updatable Cursors</xref>.</p> </section>
+For more information about updatability, see
+<xref href="rrefsqlj41360.dita#rrefsqlj41360/sqlj15384"></xref>.</p> </section>
 <refsyn><title>Syntax</title> <codeblock><b>FOR
 {
     READ ONLY | FETCH ONLY |
@@ -48,9 +48,7 @@
 <codeph>ResultSet.CONCUR_UPDATABLE</codeph> for the ResultSet to be updatable.
 </note></p> 
 <p>The optimizer is able to use an index even if the column in
-the index is being updated. For more information about how indexes affect
-cursors, see <cite><ph
-conref="../conrefs.dita#pub/cittuning"></ph></cite>.</p> 
+the index is being updated.</p> 
 </section>
 <example> <codeblock><b>SELECT RECEIVED, SOURCE, SUBJECT, NOTE_TEXT FROM SAMP.IN_TRAY FOR UPDATE
 </b></codeblock> </example>

Modified: db/derby/docs/trunk/src/tuning/ctunpropref11181.dita
URL: http://svn.apache.org/viewvc/db/derby/docs/trunk/src/tuning/ctunpropref11181.dita?rev=745679&r1=745678&r2=745679&view=diff
==============================================================================
--- db/derby/docs/trunk/src/tuning/ctunpropref11181.dita (original)
+++ db/derby/docs/trunk/src/tuning/ctunpropref11181.dita Wed Feb 18 22:39:19 2009
@@ -21,8 +21,8 @@
 <prolog>
 </prolog>
 <conbody>
-<p>This guide, <cite><ph conref="../conrefs.dita#pub/cittuning"></ph></cite>, explains how to set properties
-to configure and tune systems, databases, specific tables and indexes, and
-queries. This guide also provides performance tuning tips and an in-depth
-study of query optimization and performance issues.</p>
+<p>This guide, <cite><ph conref="../conrefs.dita#pub/cittuning"></ph></cite>,
+explains how to tune systems, databases, specific tables and indexes, and
+queries. This guide also provides performance tuning tips and an in-depth study
+of query optimization and performance issues.</p>
 </conbody></concept>

Modified: db/derby/docs/trunk/src/tuning/ctunpropref23947.dita
URL: http://svn.apache.org/viewvc/db/derby/docs/trunk/src/tuning/ctunpropref23947.dita?rev=745679&r1=745678&r2=745679&view=diff
==============================================================================
--- db/derby/docs/trunk/src/tuning/ctunpropref23947.dita (original)
+++ db/derby/docs/trunk/src/tuning/ctunpropref23947.dita Wed Feb 18 22:39:19 2009
@@ -23,8 +23,6 @@
 <conbody>
 <p>This guide includes the following sections:
 <ul>
-<li><i><xref href="ctunsetprop34818.dita#ctunsetprop34818"/></i>  
-<p>An overview of how you set properties.</p></li>
 <li><i><xref href="ctunperf22457.dita#ctunperf22457"/></i>  
 <p>Quick tips on how to improve the performance of <ph conref="../conrefs.dita#prod/productshortname"></ph> applications.</p></li>
 <li><i><xref href="ctundepth39739.dita#ctundepth39739"/></i>  

Modified: db/derby/docs/trunk/src/tuning/tuningderby.ditamap
URL: http://svn.apache.org/viewvc/db/derby/docs/trunk/src/tuning/tuningderby.ditamap?rev=745679&r1=745678&r2=745679&view=diff
==============================================================================
--- db/derby/docs/trunk/src/tuning/tuningderby.ditamap (original)
+++ db/derby/docs/trunk/src/tuning/tuningderby.ditamap Wed Feb 18 22:39:19 2009
@@ -37,40 +37,6 @@
 <topicref href="ctunpropref23947.dita" navtitle="How this guide is organized">
 </topicref>
 </topicref>
-<topicref collection-type="family" href="ctunsetprop34818.dita" navtitle="Working with Derby properties">
-<topicref collection-type="family" href="ctunsetprop11108.dita" navtitle="Properties overview">
-<topicref href="ctunsetprop824451.dita" navtitle="Scope of properties"></topicref>
-<topicref href="ctunsetprop824500.dita" navtitle="Persistence of properties">
-</topicref>
-<topicref collection-type="family" href="ctunsetprop23308.dita" navtitle="Precedence of properties">
-<topicref href="ctunsetprop824533.dita" navtitle="Protection of database-wide properties">
-</topicref>
-</topicref>
-<topicref href="ctunsetprop824615.dita" navtitle="Dynamic versus static properties">
-</topicref>
-</topicref>
-<topicref collection-type="family" href="ctunsetprop24222.dita" navtitle="Ways of setting Derby properties">
-<topicref collection-type="family" href="ctunsetprop16827.dita" navtitle="System-wide properties">
-<topicref collection-type="family" href="ctunsetprop11561.dita" navtitle="Changing the system-wide properties programmatically">
-<topicref href="ctunsetprop1003847.dita" navtitle="As a parameter to the JVM command line"
-toc="no"></topicref>
-<topicref href="ctunsetprop38343.dita" navtitle="Using a properties object within an application or statement"
-toc="no"></topicref>
-</topicref>
-<topicref href="ctunsetprop13074.dita" navtitle="Changing the system-wide properties by using the derby.properties file">
-</topicref>
-<topicref href="ctunsetprop824983.dita" navtitle="Verifying system properties">
-</topicref>
-</topicref>
-<topicref href="ctunsetprop12821.dita" navtitle="Database-wide properties">
-</topicref>
-<topicref href="ctunsetprop24843.dita" navtitle="In a client/server environment">
-</topicref>
-<topicref href="ctunsetprop44147.dita" navtitle="Dynamic or static changes to properties">
-</topicref>
-</topicref>
-<topicref href="ctunsetprop32443.dita" navtitle="Properties case study"></topicref>
-</topicref>
 <topicref collection-type="family" href="ctunperf22457.dita" navtitle="Performance tips and tricks">
 <topicref collection-type="family" href="ctunperf25864.dita" navtitle="The tips">
 <topicref href="ctunperf18705.dita" navtitle="Use prepared statements with substitution parameters">



Mime
View raw message