db-derby-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From chaa...@apache.org
Subject svn commit: r713746 [2/3] - /db/derby/docs/trunk/src/ref/
Date Thu, 13 Nov 2008 16:09:46 GMT
Added: db/derby/docs/trunk/src/ref/rrefproper32066.dita
URL: http://svn.apache.org/viewvc/db/derby/docs/trunk/src/ref/rrefproper32066.dita?rev=713746&view=auto
==============================================================================
--- db/derby/docs/trunk/src/ref/rrefproper32066.dita (added)
+++ db/derby/docs/trunk/src/ref/rrefproper32066.dita Thu Nov 13 08:09:44 2008
@@ -0,0 +1,50 @@
+<?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 reference PUBLIC "-//OASIS//DTD DITA Reference//EN" "../dtd/reference.dtd">
+<reference xml:lang="en-us" id="rrefproper32066">
+<title>derby.system.home</title>
+<prolog><metadata>
+<keywords><indexterm>derby.system.home</indexterm>
+</keywords>
+</metadata>
+</prolog><refbody>
+<section><title>Function</title>
+<p>Specifies the <ph conref="../conrefs.dita#prod/productshortname"></ph> system
+directory, which is the directory that contains subdirectories holding databases
+that you create and the text file <i>derby.properties</i>.</p>
+<p>If the system directory that you specify with <i>derby.system.home</i> does
+not exist at startup, <ph conref="../conrefs.dita#prod/productshortname"></ph>
+creates the directory automatically.</p>
+</section>
+<section><title>Default</title>
+<p>Current directory (the value of the JVM system property <i>user.dir</i>).</p>
+<p>If you do not explicitly set the <i>derby.system.home</i> property when
+starting <ph conref="../conrefs.dita#prod/productshortname"></ph>, the default
+is the directory in which
+<ph conref="../conrefs.dita#prod/productshortname"></ph> was started.</p>   
+<note>You should always explicitly set the value of
+<i>derby.system.home</i>.</note>
+</section>
+<example><title>Example</title>
+<codeblock><b>-Dderby.system.home=C:\<ph conref="../conrefs.dita#prod/productlowercase"></ph></b></codeblock>
+</example>
+<section><title>Dynamic or static</title>
+<p>This property is static; if you change it while
+<ph conref="../conrefs.dita#prod/productshortname"></ph> is running, the change
+does not take effect until you reboot.</p>
+</section></refbody></reference>

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

Added: db/derby/docs/trunk/src/ref/rrefproper32213.dita
URL: http://svn.apache.org/viewvc/db/derby/docs/trunk/src/ref/rrefproper32213.dita?rev=713746&view=auto
==============================================================================
--- db/derby/docs/trunk/src/ref/rrefproper32213.dita (added)
+++ db/derby/docs/trunk/src/ref/rrefproper32213.dita Thu Nov 13 08:09:44 2008
@@ -0,0 +1,24 @@
+<?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 reference PUBLIC "-//OASIS//DTD DITA Reference//EN" "../dtd/reference.dtd">
+<reference xml:lang="en-us" id="rrefproper32213">
+<title>Derby properties</title>
+<prolog>
+</prolog>
+<refbody>
+</refbody></reference>

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

Added: db/derby/docs/trunk/src/ref/rrefproper33027.dita
URL: http://svn.apache.org/viewvc/db/derby/docs/trunk/src/ref/rrefproper33027.dita?rev=713746&view=auto
==============================================================================
--- db/derby/docs/trunk/src/ref/rrefproper33027.dita (added)
+++ db/derby/docs/trunk/src/ref/rrefproper33027.dita Thu Nov 13 08:09:44 2008
@@ -0,0 +1,54 @@
+<?xml version="1.0" encoding="utf-8"?>
+<!DOCTYPE reference PUBLIC "-//OASIS//DTD DITA Reference//EN"
+ "../dtd/reference.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.
+-->
+<reference id="rrefproper33027" xml:lang="en-us">
+<title>derby.stream.error.field</title>
+<prolog><metadata>
+<keywords><indexterm>derby.stream.error.field</indexterm>
+<indexterm>Error log<indexterm>redirecting to a stream</indexterm></indexterm></keywords>
+</metadata></prolog>
+<refbody>
+<section><title>Function</title>
+<p>Specifies a static field that references a stream to which the error log is
+written. The field is specified using the fully qualified name of the class,
+then a dot (.) and then the field name. The field must be public and static. Its
+type can be either <i>java.io.OutputStream</i> or <i>java.io.Writer</i>. </p>
+<p>The field is accessed once at
+<ph conref="../conrefs.dita#prod/productshortname"></ph> boot time, and the
+value is used until <ph conref="../conrefs.dita#prod/productshortname"></ph> is
+rebooted. If the field is null, the error stream defaults to the system error
+stream (<i>java.lang.System.err</i>).</p>
+<p>If the field does not exist or is inaccessible, the error stream defaults to
+the system error stream. 
+<ph conref="../conrefs.dita#prod/productshortname"></ph> will not call the
+<i>close()</i> method of the object obtained from the field.</p> </section>
+<section><title>Default</title>
+<p>None.</p> </section>
+<example><title>Example</title>
+<codeblock><b>derby.stream.error.field=java.lang.System.err</b></codeblock>
+</example>
+<section><title>Scope</title>
+<p><xref href="crefproper51399.dita#crefproper51399/rrefproper41229">system-wide</xref></p>
+</section>
+<section><title>Dynamic or static</title>
+<p>This property is static; if you change it while
+<ph conref="../conrefs.dita#prod/productshortname"></ph> is running, the change
+does not take effect until you reboot.</p> </section>
+</refbody>
+</reference>

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

Added: db/derby/docs/trunk/src/ref/rrefproper34037.dita
URL: http://svn.apache.org/viewvc/db/derby/docs/trunk/src/ref/rrefproper34037.dita?rev=713746&view=auto
==============================================================================
--- db/derby/docs/trunk/src/ref/rrefproper34037.dita (added)
+++ db/derby/docs/trunk/src/ref/rrefproper34037.dita Thu Nov 13 08:09:44 2008
@@ -0,0 +1,76 @@
+<?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 reference PUBLIC "-//OASIS//DTD DITA Reference//EN" "../dtd/reference.dtd">
+<reference xml:lang="en-us" id="rrefproper34037">
+<title>derby.storage.tempDirectory</title>
+<prolog><metadata>
+<keywords><indexterm>derby.storage.tempDirectory</indexterm>
+<indexterm>tmp directory<indexterm>setting location for</indexterm></indexterm>
+</keywords>
+</metadata>
+</prolog><refbody>
+<section><title>Function</title>
+<p>Defines the location on disk for temporary file space needed by
+<ph conref="../conrefs.dita#prod/productshortname"></ph> for performing large
+sorts and deferred deletes and updates. (Temporary files are automatically
+deleted after use, and are removed when the database restarts after a crash.)
+The temporary directory named by this property will be created if it does not
+exist, but will not be deleted when the system shuts down. The path name
+specified by this property must have file separators that are appropriate to the
+current operating system.</p>
+<p>This property allows databases located on read-only media to write temporary
+files to a writable location. If this property is not set, databases located
+on read-only media might get an error like the following:</p>
+<codeblock>ERROR XSDF1: Exception during creation 
+	of file  c:\databases\db\tmp\T887256591756.tmp
+for container
+ERROR XJ001: Java exception:
+'a:\databases\db\tmp\T887256591756.tmp: java.io.IOException'.</codeblock>
+<p>This property moves the temporary directories for all databases being used
+by the <ph conref="../conrefs.dita#prod/productshortname"></ph> system.
+<ph conref="../conrefs.dita#prod/productshortname"></ph> makes temporary
+directories for each database under the directory referenced by this property.
+For example, if the property is set as follows:</p>
+<codeblock><b>derby.storage.tempDirectory=C:/Temp/dbtemp</b></codeblock>
+<p>the temporary directories for the databases in <i>C:\databases\db1</i> and
+<i>C:\databases\db2</i> will be in <i>C:\Temp\dbtemp\db1</i> and
+<i>C:\Temp\dbtemp\db2</i>, respectively.</p>
+<p>The temporary files of two databases running concurrently with the same name
+(for example, <i>C:\databases\db1</i> and <i>E:\databases\db1</i>) will
+conflict with each other if the <i>derby.storage.tempDirectory</i> property is
+set. This will cause incorrect results, so users are advised to give databases
+unique names.</p>
+</section>
+<section><title>Default</title>
+<p>A subdirectory named <i>tmp</i> under the database directory.</p>
+<p>For example, if the database <i>db1</i> is stored in <i>C:\databases\db1</i>,
+the temporary files are created in <i>C:\databases\db1\tmp</i>.</p>
+</section>
+<example><title>Example</title>
+<codeblock><b><ph>-- system-wide property</ph>
+derby.storage.tempDirectory=c:/Temp/dbtemp
+<ph>-- database-wide property</ph>
+CALL SYSCS_UTIL.SYSCS_SET_DATABASE_PROPERTY(
+    'derby.storage.tempDirectory',
+    'c:/Temp/dbtemp')</b></codeblock>
+</example>
+<section><title>Dynamic or static</title>
+<p>This property is static; you must restart
+<ph conref="../conrefs.dita#prod/productshortname"></ph> for a change to take
+effect.</p>
+</section></refbody></reference>

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

Added: db/derby/docs/trunk/src/ref/rrefproper35028.dita
URL: http://svn.apache.org/viewvc/db/derby/docs/trunk/src/ref/rrefproper35028.dita?rev=713746&view=auto
==============================================================================
--- db/derby/docs/trunk/src/ref/rrefproper35028.dita (added)
+++ db/derby/docs/trunk/src/ref/rrefproper35028.dita Thu Nov 13 08:09:44 2008
@@ -0,0 +1,57 @@
+<?xml version="1.0" encoding="utf-8"?>
+<!DOCTYPE reference PUBLIC "-//OASIS//DTD DITA Reference//EN"
+ "../dtd/reference.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.
+-->
+<reference id="rrefproper35028" xml:lang="en-us">
+<title>derby.stream.error.method</title>
+<prolog><metadata>
+<keywords><indexterm>derby.stream.error.method</indexterm>
+<indexterm>Error log<indexterm>redirecting to a stream</indexterm></indexterm>
+</keywords>
+</metadata></prolog>
+<refbody>
+<section><title>Function</title>
+<p>Specifies a static method that returns a stream to which the
+<ph conref="../conrefs.dita#prod/productshortname"></ph> error log is
+written.</p>
+<p>Specify the method using the fully qualified name of the class, then a dot
+(.) and then the method name. The method must be public and static. Its return
+type can be either <i>java.io.OutputStream </i>or <i>java.io.Writer</i>.
+<ph conref="../conrefs.dita#prod/productshortname"></ph> will not call the
+<i>close()</i> method of the object returned by the method.</p>
+<p>The method is called once at
+<ph conref="../conrefs.dita#prod/productshortname"></ph> boot time, and the
+return value is used for the lifetime of
+<ph conref="../conrefs.dita#prod/productshortname"></ph>. If the method returns
+null, the error stream defaults to the system error stream. If the method does
+not exist or is inaccessible, the error stream defaults to the system error
+stream (<i>java.lang.System.err</i>).</p>
+<p>If the value of this property is set, the property
+<i>derby.stream.error.field</i> is ignored.</p> </section>
+<section><title>Default</title>
+<p>Not set.</p> </section>
+<example><title>Example</title>
+<codeblock><b>derby.stream.error.method=java.sql.DriverManager.getLogStream</b></codeblock> </example>
+<section><title>Scope</title>
+<p><xref href="crefproper51399.dita#crefproper51399/rrefproper41229">system-wide</xref></p> </section>
+<section><title>Dynamic or static</title>
+<p>This property is static; if you change it while
+<ph conref="../conrefs.dita#prod/productshortname"></ph> is running, the change
+does not take effect until you reboot.</p> </section>
+</refbody>
+</reference>

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

Added: db/derby/docs/trunk/src/ref/rrefproper37341.dita
URL: http://svn.apache.org/viewvc/db/derby/docs/trunk/src/ref/rrefproper37341.dita?rev=713746&view=auto
==============================================================================
--- db/derby/docs/trunk/src/ref/rrefproper37341.dita (added)
+++ db/derby/docs/trunk/src/ref/rrefproper37341.dita Thu Nov 13 08:09:44 2008
@@ -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 reference PUBLIC "-//OASIS//DTD DITA Reference//EN" "../dtd/reference.dtd">
+<reference xml:lang="en-us" id="rrefproper37341">
+<title>derby.authentication.ldap.searchFilter</title>
+<prolog><metadata>
+<keywords><indexterm>derby.authentication.ldap.searchfilter</indexterm>
+<indexterm>LDAP<indexterm>configuring</indexterm></indexterm>
+</keywords>
+</metadata>
+</prolog><refbody>
+<section><title>Function</title>
+<p>Specifies the search filter to use to determine what constitutes a user
+(and other search predicate) for
+<ph conref="../conrefs.dita#prod/productshortname"></ph> searches for a full DN
+during user authentication.</p>
+<p>If you set this property to <i>derby.user</i>,
+<ph conref="../conrefs.dita#prod/productshortname"></ph> looks for cached full
+DNs for users that you have defined with the
+<i><xref href="rrefproper27355.dita#rrefproper27355">derby.user.UserName</xref></i>
+property. For other users,
+<ph conref="../conrefs.dita#prod/productshortname"></ph> performs a search using
+the <i>default</i> search filter.</p>
+<p>For more information about LDAP user authentication, see "LDAP directory
+service" in the <ph conref="../conrefs.dita#pub/citdevelop"></ph>.</p>
+</section>
+<refsyn><title>Syntax</title>
+<codeblock><b>derby.authentication.ldap.searchFilter=
+    {<i> searchFilter</i> | derby.user)</b></codeblock>
+</refsyn>
+<section><title>Default</title>
+<codeblock><b>(&amp;(objectClass=inetOrgPerson)(uid=<i>userName</i>))</b></codeblock>
+<note><ph conref="../conrefs.dita#prod/productshortname"></ph> automatically
+uses the filter you specify with ((uid=<i>userName</i>)) unless you include
+%USERNAME% in the definition. You might want to use %USERNAME% if your user DNs
+map the user name to something other than <i>uid </i>(for example,
+<i>user</i>).</note>
+</section>
+<example><title>Example</title>
+<codeblock><b><ph>-- system-wide properties</ph>
+derby.authentication.ldap.searchFilter=objectClass=person
+<ph>## people in the marketing department
+## <ph conref="../conrefs.dita#prod/productshortname"></ph> automatically adds (uid=&lt;userName&gt;)</ph>
+derby.authentication.ldap.searchFilter=(&amp;(ou=Marketing)
+    (objectClass=person))
+<ph>## all people but those in marketing
+## <ph conref="../conrefs.dita#prod/productshortname"></ph> automatically adds (uid=&lt;userName&gt;)</ph>
+derby.authentication.ldap.searchFilter=(&amp;(!(ou=Marketing)
+    (objectClass=person))
+<ph>## map %USERNAME% to user, not <i>uid</i></ph>
+derby.authentication.ldap.searchFilter=(&amp;((ou=People)
+(user=%USERNAME%))
+<ph>## cache user DNs locally and use the default for others</ph>
+derby.authentication.ldap.searchFilter=derby.user
+
+<ph>-- database-wide property</ph>
+CALL SYSCS_UTIL.SYSCS_SET_DATABASE_PROPERTY(
+    'derby.authentication.ldap.searchFilter',
+    'objectClass=person')</b></codeblock>
+</example>
+<section><title>Dynamic or static</title>
+<p>Static. For system-wide properties, you must reboot
+<ph conref="../conrefs.dita#prod/productshortname"></ph> for the change to take
+effect. For database-wide properties, you must reboot the database for the
+change to take effect.</p>
+</section></refbody></reference>

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

Added: db/derby/docs/trunk/src/ref/rrefproper39325.dita
URL: http://svn.apache.org/viewvc/db/derby/docs/trunk/src/ref/rrefproper39325.dita?rev=713746&view=auto
==============================================================================
--- db/derby/docs/trunk/src/ref/rrefproper39325.dita (added)
+++ db/derby/docs/trunk/src/ref/rrefproper39325.dita Thu Nov 13 08:09:44 2008
@@ -0,0 +1,58 @@
+<?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 reference PUBLIC "-//OASIS//DTD DITA Reference//EN" "../dtd/reference.dtd">
+<reference xml:lang="en-us" id="rrefproper39325">
+<title>derby.database.readOnlyAccessUsers</title>
+<prolog><metadata>
+<keywords><indexterm>derby.database.readOnlyAccessUsers</indexterm>
+<indexterm>User authorization<indexterm>configuring</indexterm></indexterm>
+</keywords>
+</metadata>
+</prolog><refbody>
+<section><title>Function</title>
+<p>One of the user authorization properties. Specifies a list of users to
+which read-only access to a database is granted. The list consists of user
+names separated by commas. Do not put spaces after commas.</p>
+<p>When set as a system property, specifies a list of users for which read-only
+access to all the databases in the system is granted.</p>
+<p>See also
+<i><xref href="rrefproper25025.dita#rrefproper25025">derby.database.fullAccessUsers</xref></i>.</p>
+<p>A malformed list of user names raises an exception. Do not specify a user
+both in this property and in <i>derby.database.fullAccessUsers</i>.</p>  
+<note>User names, called authorization identifiers,
+follow the rules of <i>SQL92Identifiers</i> and can be delimited.
+Specifying a user name that does not follow these rules raises an exception.</note>
+</section>
+<refsyn><title>Syntax</title>
+<codeblock><b><b>-- database-level property</b>
+CALL SYSCS_UTIL.SYSCS_SET_DATABASE_PROPERTY(
+    'derby.database.readOnlyAccessUsers',
+    '<b><i>commaSeparatedListOfUsers</i></b>')</b></codeblock>
+</refsyn>
+<example><title>Example</title>
+<codeblock><b><ph>-- database-level property</ph>
+CALL SYSCS_UTIL.SYSCS_SET_DATABASE_PROPERTY(
+    'derby.database.readOnlyAccessUsers', 'ralph,guest')
+<ph>-- system-level property</ph>
+derby.database.readOnlyAccessUsers=ralph,guest</b></codeblock>
+</example>
+<section><title>Dynamic or static</title>
+<p>Dynamic. Current connection is not affected, but all future connections
+are affected. For information about dynamic changes to properties, see
+<xref href="crefproperdynstat.dita#crefproperdynstat"/>.</p>
+</section></refbody></reference>

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

Added: db/derby/docs/trunk/src/ref/rrefproper40346.dita
URL: http://svn.apache.org/viewvc/db/derby/docs/trunk/src/ref/rrefproper40346.dita?rev=713746&view=auto
==============================================================================
--- db/derby/docs/trunk/src/ref/rrefproper40346.dita (added)
+++ db/derby/docs/trunk/src/ref/rrefproper40346.dita Thu Nov 13 08:09:44 2008
@@ -0,0 +1,65 @@
+<?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 reference PUBLIC "-//OASIS//DTD DITA Reference//EN" "../dtd/reference.dtd">
+<reference xml:lang="en-us" id="rrefproper40346">
+<title>derby.locks.escalationThreshold</title>
+<prolog><metadata>
+<keywords><indexterm>derby.locks.escalationThreshold</indexterm>
+<indexterm>Lock escalation</indexterm>
+</keywords>
+</metadata>
+</prolog><refbody>
+<section><title>Function</title>
+<p>Used by the <ph conref="../conrefs.dita#prod/productshortname"></ph> system
+at runtime in determining when to attempt to escalate locking for at least one
+of the tables involved in a transaction from row-level locking to table-level
+locking.</p>
+<p>A large number of row locks use a lot of resources. If nearly all the rows
+are locked, it might be worth the slight decrease in concurrency to lock the
+entire table to avoid the large number of row locks.</p>
+<p>For more information, see "Locking and performance" in 
+<ph conref="../conrefs.dita#pub/cittuning"></ph>.</p>
+<p>It is useful to increase this value for large systems (such as
+enterprise-level servers, where there is more than 64 MB of memory), and to
+decrease it for very small systems (such as palmtops).</p>
+</section>
+<refsyn><title>Syntax</title>
+<codeblock><b>derby.locks.escalationThreshold=<i>numberOfLocks</i></b></codeblock>
+</refsyn>
+<section><title>Default</title>
+<p>5000.</p>
+</section>
+<section><title>Minimum value</title>
+<p>100.</p>
+</section>
+<section><title>Maximum value</title>
+<p>2,147,483,647.</p>
+</section>
+<example><title>Example</title>
+<codeblock><b><ph>-- system-wide property</ph>
+derby.locks.escalationThreshold=1000
+<ph>-- database-wide property</ph>
+CALL SYSCS_UTIL.SYSCS_SET_DATABASE_PROPERTY(
+    'derby.locks.escalationThreshold',
+    '1000')</b></codeblock>
+</example>
+<section><title>Dynamic or static</title>
+<p>Dynamic; the change takes effect immediately. For information about dynamic
+changes to properties, see
+<xref href="crefproperdynstat.dita#crefproperdynstat"/>.</p>
+</section></refbody></reference>

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

Added: db/derby/docs/trunk/src/ref/rrefproper40688.dita
URL: http://svn.apache.org/viewvc/db/derby/docs/trunk/src/ref/rrefproper40688.dita?rev=713746&view=auto
==============================================================================
--- db/derby/docs/trunk/src/ref/rrefproper40688.dita (added)
+++ db/derby/docs/trunk/src/ref/rrefproper40688.dita Thu Nov 13 08:09:44 2008
@@ -0,0 +1,64 @@
+<?xml version="1.0" encoding="utf-8"?>
+
+<!DOCTYPE reference PUBLIC "-//OASIS//DTD DITA Reference//EN"
+ "../dtd/reference.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.
+-->
+<reference id="rrefproper40688" xml:lang="en-us">
+<title>derby.storage.pageSize</title>
+<prolog><metadata>
+<keywords><indexterm>derby.storage.pageSize</indexterm>
+<indexterm>Page size<indexterm>configuring</indexterm></indexterm>
+</keywords>
+</metadata></prolog>
+<refbody>
+<section><title>Function</title>
+<p>Defines the page size, in bytes, for on-disk database pages for tables or
+indexes used during table or index creation. Set this property prior to issuing
+the CREATE TABLE or CREATE INDEX statement. This value will be used for the
+lifetime of the newly created conglomerates.</p>
+</section>
+<section><title>Valid conglomerates</title>
+<p>Tables and indexes, including the indexes created to enforce constraints.</p>
+</section>
+<section><title>Default</title>
+<p><ph conref="../conrefs.dita#prod/productshortname"></ph> automatically tunes
+for the database page size. If you have long columns, the default page size for
+the table is set to 32768 bytes. Otherwise, the default is 4096 bytes.</p>
+</section>
+<section><title>Valid values</title>
+<p>Page size can only be one the following values: 4096, 8192, 16384, or 32768
+bytes. If you specify an invalid value,
+<ph conref="../conrefs.dita#prod/productshortname"></ph> uses the default
+value.</p>
+</section>
+<example><title>Example</title>
+<codeblock><b><ph>-- changing the default for the system</ph>
+derby.storage.pageSize=8192
+<ph>-- changing the default for the database</ph>
+CALL SYSCS_UTIL.SYSCS_SET_DATABASE_PROPERTY( 
+    'derby.storage.pageSize',
+    '8192')</b></codeblock>
+</example>
+<section><title>Dynamic or static</title>
+<p>This property is dynamic; if you change it while
+<ph conref="../conrefs.dita#prod/productshortname"></ph> is running, the change
+takes effect immediately. For information about dynamic changes to properties,
+see <xref href="crefproperdynstat.dita#crefproperdynstat"/>.</p>
+</section>
+</refbody>
+</reference>

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

Added: db/derby/docs/trunk/src/ref/rrefproper43414.dita
URL: http://svn.apache.org/viewvc/db/derby/docs/trunk/src/ref/rrefproper43414.dita?rev=713746&view=auto
==============================================================================
--- db/derby/docs/trunk/src/ref/rrefproper43414.dita (added)
+++ db/derby/docs/trunk/src/ref/rrefproper43414.dita Thu Nov 13 08:09:44 2008
@@ -0,0 +1,44 @@
+<?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 reference PUBLIC "-//OASIS//DTD DITA Reference//EN" "../dtd/reference.dtd">
+<reference xml:lang="en-us" id="rrefproper43414">
+<title>derby.language.logQueryPlan</title>
+<prolog><metadata>
+<keywords><indexterm>derby.language.logQueryPlan</indexterm>
+<indexterm>Statement execution<indexterm>debugging</indexterm></indexterm>
+<indexterm>Statements<indexterm>debugging</indexterm></indexterm>
+</keywords>
+</metadata>
+</prolog><refbody>
+<section><title>Function</title>
+<p>When this property is set to true,
+<ph conref="../conrefs.dita#prod/productshortname"></ph> writes the query plan
+information into the <codeph>derby.log</codeph> file for all executed queries.
+This information can help you debug problems within a system.</p>
+</section>
+<example><title>Example</title>
+<codeblock><b>derby.language.logQueryPlan=true</b></codeblock>
+</example>
+<section><title>Default</title>
+<p>False.</p>
+</section>
+<section><title>Dynamic or static</title>
+<p>This property is static; if you change it while
+<ph conref="../conrefs.dita#prod/productshortname"></ph> is running, the change
+does not take effect until you reboot.</p>
+</section></refbody></reference>

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

Added: db/derby/docs/trunk/src/ref/rrefproper43517.dita
URL: http://svn.apache.org/viewvc/db/derby/docs/trunk/src/ref/rrefproper43517.dita?rev=713746&view=auto
==============================================================================
--- db/derby/docs/trunk/src/ref/rrefproper43517.dita (added)
+++ db/derby/docs/trunk/src/ref/rrefproper43517.dita Thu Nov 13 08:09:44 2008
@@ -0,0 +1,49 @@
+<?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 reference PUBLIC "-//OASIS//DTD DITA Reference//EN" "../dtd/reference.dtd">
+<reference xml:lang="en-us" id="rrefproper43517">
+<title>derby.language.logStatementText</title>
+<prolog><metadata>
+<keywords><indexterm>derby.language.logStatementText</indexterm>
+<indexterm>Statement execution<indexterm>debugging</indexterm></indexterm>
+<indexterm>Statements<indexterm>debugging</indexterm></indexterm>
+</keywords>
+</metadata>
+</prolog><refbody>
+<section><title>Function</title>
+<p>When this property is set to true,
+<ph conref="../conrefs.dita#prod/productshortname"></ph> writes the text and
+parameter values of all executed statements to the information log at the
+beginning of execution. It also writes information about commits and rollbacks.
+Information includes the time and thread number.</p>
+<p>This property is useful for debugging.</p>
+</section>
+<example><title>Example</title>
+<codeblock><b>derby.language.logStatementText=true
+<ph>-- database-wide property</ph>
+CALL SYSCS_UTIL.SYSCS_SET_DATABASE_PROPERTY(
+    'derby.language.logStatementText', 'true')</b></codeblock>
+</example>
+<section><title>Default</title>
+<p>False.</p>
+</section>
+<section><title>Dynamic or static</title>
+<p>This property is static; if you change it while
+<ph conref="../conrefs.dita#prod/productshortname"></ph> is running, the change
+does not take effect until you reboot.</p>
+</section></refbody></reference>

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

Added: db/derby/docs/trunk/src/ref/rrefproper46141.dita
URL: http://svn.apache.org/viewvc/db/derby/docs/trunk/src/ref/rrefproper46141.dita?rev=713746&view=auto
==============================================================================
--- db/derby/docs/trunk/src/ref/rrefproper46141.dita (added)
+++ db/derby/docs/trunk/src/ref/rrefproper46141.dita Thu Nov 13 08:09:44 2008
@@ -0,0 +1,58 @@
+<?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 reference PUBLIC "-//OASIS//DTD DITA Reference//EN" "../dtd/reference.dtd">
+<reference xml:lang="en-us" id="rrefproper46141">
+<title>derby.locks.waitTimeout</title>
+<prolog><metadata>
+<keywords><indexterm>derby.locks.waitTimeout</indexterm>
+<indexterm>Deadlocks<indexterm>wait timeout property</indexterm></indexterm>
+</keywords>
+</metadata>
+</prolog><refbody>
+<section><title>Function</title>
+<p>Specifies the number of seconds after which
+<ph conref="../conrefs.dita#prod/productshortname"></ph> aborts a transaction
+when it is waiting for a lock. When
+<ph conref="../conrefs.dita#prod/productshortname"></ph> aborts (and rolls back)
+the transaction, the transaction receives an <i>SQLException</i> of
+<i>SQLState</i> 40XL1.</p>
+<p>The time specified by this property is approximate.</p>
+<p>A zero value for this property means that
+<ph conref="../conrefs.dita#prod/productshortname"></ph> aborts a transaction
+any time it cannot immediately obtain a lock that it requests.</p>
+<p>A negative value for this property is equivalent to an infinite wait time;
+the transaction waits forever to obtain the lock.</p>
+<p>If this property is set to a value greater than or equal to zero but less
+than the value of
+<i><xref href="rrefproper10607.dita#rrefproper10607">derby.locks.deadlockTimeout</xref></i>,
+<ph conref="../conrefs.dita#prod/productshortname"></ph> never performs any
+deadlock checking.</p>
+</section>
+<section><title>Default</title>
+<p>60 seconds.</p>
+</section>
+<example><title>Example</title>
+<codeblock><b>CALL SYSCS_UTIL.SYSCS_SET_DATABASE_PROPERTY(
+    'derby.locks.waitTimeout', '15')
+derby.locks.waitTimeout=60</b></codeblock>
+</example>
+<section><title>Dynamic or static</title>
+<p>Dynamic; the change takes effect immediately. For information about dynamic
+changes to properties, see
+<xref href="crefproperdynstat.dita#crefproperdynstat"/>.</p>
+</section></refbody></reference>

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

Added: db/derby/docs/trunk/src/ref/rrefproper81359.dita
URL: http://svn.apache.org/viewvc/db/derby/docs/trunk/src/ref/rrefproper81359.dita?rev=713746&view=auto
==============================================================================
--- db/derby/docs/trunk/src/ref/rrefproper81359.dita (added)
+++ db/derby/docs/trunk/src/ref/rrefproper81359.dita Thu Nov 13 08:09:44 2008
@@ -0,0 +1,68 @@
+<?xml version="1.0" encoding="utf-8"?>
+
+<!DOCTYPE reference PUBLIC "-//OASIS//DTD DITA Reference//EN"
+ "../dtd/reference.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.
+-->
+<reference id="rrefproper81359" xml:lang="en-us">
+<title>derby.storage.pageCacheSize</title>
+<prolog><metadata>
+<keywords>
+<indexterm>derby.storage.pageCacheSize</indexterm>
+<indexterm>Page cache size<indexterm>configuring</indexterm></indexterm>
+</keywords>
+</metadata></prolog>
+<refbody>
+<section><title>Function</title>
+<p>Defines the size, in number of pages, of the data page cache in the database
+(data pages kept in memory).</p>
+<p>The actual amount of memory the page cache will use depends on the
+following:</p>
+<ul>
+<li>The size of the cache, configured with the
+<i>derby.storage.pageCacheSize</i> property.</li>
+<li>The size of the pages, configured with the
+<i><xref href="rrefproper40688.dita#rrefproper40688">derby.storage.pageSize</xref></i>
+property. <ph conref="../conrefs.dita#prod/productshortname"></ph> automatically
+tunes for the database page size. If you have long columns, the default page
+size for the table is set to 32768 bytes. Otherwise, the default is 4096
+bytes.</li>
+<li>Overhead, which varies with JVMs.</li>
+</ul>
+<p>When increasing the size of the page cache, you typically have to allow more
+memory for the Java heap when starting the embedding application (taking into
+consideration, of course, the memory needs of the embedding application as
+well). For example, using the default page size of 4K, a page cache size of 2000
+pages will require at least 8 MB of memory (and probably more, given the
+overhead).</p>
+<p>For a simple application (no GUI), using the Sun 1.1.7 JVM on Windows NT and
+using the -mx96m option (which allows 96 MB for the Java heap), it is possible
+to have a page cache size of 10,000 pages (approximately 40 MB).</p>
+<p>The minimum value is 40 pages. If you specify a lower value,
+<ph conref="../conrefs.dita#prod/productshortname"></ph> uses the default
+value.</p> </section>
+<section><title>Default</title>
+<p>1000 pages.</p>
+</section>
+<example><title>Example</title>
+<codeblock><b>derby.storage.pageCacheSize=160</b></codeblock>
+</example>
+<section><title>Dynamic or static</title>
+<p>Static. You must reboot the system for the change to take effect.</p>
+</section>
+</refbody>
+</reference>

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

Added: db/derby/docs/trunk/src/ref/rrefproper81405.dita
URL: http://svn.apache.org/viewvc/db/derby/docs/trunk/src/ref/rrefproper81405.dita?rev=713746&view=auto
==============================================================================
--- db/derby/docs/trunk/src/ref/rrefproper81405.dita (added)
+++ db/derby/docs/trunk/src/ref/rrefproper81405.dita Thu Nov 13 08:09:44 2008
@@ -0,0 +1,64 @@
+<?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 reference PUBLIC "-//OASIS//DTD DITA Reference//EN" "../dtd/reference.dtd">
+<reference xml:lang="en-us" id="rrefproper81405">
+<title>derby.database.forceDatabaseLock</title>
+<prolog><metadata>
+<keywords><indexterm>derby.database.forceDatabaseLock</indexterm>
+</keywords>
+</metadata>
+</prolog><refbody>
+<section><title>Function</title>
+<p>On some platforms, if set to true, prevents
+<ph conref="../conrefs.dita#prod/productshortname"></ph> from booting a database
+if a <i>db.lck</i> file is present in the database directory.</p>
+<p><ph conref="../conrefs.dita#prod/productshortname"></ph> attempts to prevent
+two JVMs from accessing a database at one time (and potentially corrupting it)
+with the use of a file called <i>db.lck</i> in the database directory. On some
+operating systems, the use of a lock file does not guarantee single access, and
+so <ph conref="../conrefs.dita#prod/productshortname"></ph> only issues
+a warning and might allow multiple JVM access even when the file is present.
+(For more information, see "Double-booting system behavior" in the
+<ph conref="../conrefs.dita#pub/citdevelop"></ph>.)</p>
+<p><ph conref="../conrefs.dita#prod/productshortname"></ph> provides the
+property <i>derby.database.forceDatabaseLock</i> for use on platforms that do
+not provide the ability for
+<ph conref="../conrefs.dita#prod/productshortname"></ph> to guarantee single
+JVM access. By default, this property is set to false. When this property is
+set to true, if <ph conref="../conrefs.dita#prod/productshortname"></ph> finds
+the <i>db.lck</i> file when it attempts to boot the database, it throws an
+exception and does not boot the database. </p>  
+<note>This situation can occur even when no other JVMs are accessing the
+database; in that case, remove the <i>db.lck</i> file by hand in order to boot
+the database. If the <i>db.lck</i> file is removed by hand while a JVM is still
+accessing a <ph conref="../conrefs.dita#prod/productshortname"></ph> database,
+there is no way for <ph conref="../conrefs.dita#prod/productshortname"></ph> to
+prevent a second VM from starting up and possibly corrupting the database.
+In this situation no warning message is logged to the error log.</note>
+</section>
+<section><title>Default</title>
+<p>False.</p>
+</section>
+<example><title>Example</title>
+<codeblock><b>derby.database.forceDatabaseLock=true</b></codeblock>
+</example>
+<section><title>Dynamic or static</title>
+<p>This property is static; if you change it while
+<ph conref="../conrefs.dita#prod/productshortname"></ph> is running, the change
+does not take effect until you reboot.</p>
+</section></refbody></reference>

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

Added: db/derby/docs/trunk/src/ref/rrefproper98166.dita
URL: http://svn.apache.org/viewvc/db/derby/docs/trunk/src/ref/rrefproper98166.dita?rev=713746&view=auto
==============================================================================
--- db/derby/docs/trunk/src/ref/rrefproper98166.dita (added)
+++ db/derby/docs/trunk/src/ref/rrefproper98166.dita Thu Nov 13 08:09:44 2008
@@ -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 reference PUBLIC "-//OASIS//DTD DITA Reference//EN" "../dtd/reference.dtd">
+<reference xml:lang="en-us" id="rrefproper98166">
+<title>derby.locks.monitor</title>
+<prolog><metadata>
+<keywords><indexterm>derby.locks.monitor</indexterm>
+<indexterm>Locks<indexterm>monitoring</indexterm></indexterm>
+<indexterm>Deadlocks<indexterm>monitoring</indexterm></indexterm>
+</keywords>
+</metadata>
+</prolog><refbody>
+<section><title>Function</title>
+<p>Specifies that all deadlock errors are logged to the error log. If
+<i><xref href="rrefproper26985.dita#rrefproper26985">derby.stream.error.logSeverityLevel</xref></i>
+is set to ignore deadlock errors, <i>derby.locks.monitor</i> overrides it.</p>
+</section>
+<section><title>Default</title>
+<p>False.</p>
+</section>
+<example><title>Example</title>
+<codeblock><b><ph>-- system property</ph>
+derby.locks.monitor=true
+
+CALL SYSCS_UTIL.SYSCS_SET_DATABASE_PROPERTY(
+    'derby.locks.monitor', 'true')</b></codeblock>
+</example>
+<section><title>Dynamic or static</title>
+<p>Dynamic; the change takes effect immediately. For information about dynamic
+changes to properties, see
+<xref href="crefproperdynstat.dita#crefproperdynstat"/>.</p>
+</section></refbody></reference>

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

Added: db/derby/docs/trunk/src/ref/rrefproperauthdn.dita
URL: http://svn.apache.org/viewvc/db/derby/docs/trunk/src/ref/rrefproperauthdn.dita?rev=713746&view=auto
==============================================================================
--- db/derby/docs/trunk/src/ref/rrefproperauthdn.dita (added)
+++ db/derby/docs/trunk/src/ref/rrefproperauthdn.dita Thu Nov 13 08:09:44 2008
@@ -0,0 +1,60 @@
+<?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 reference PUBLIC "-//OASIS//DTD DITA Reference//EN" "../dtd/reference.dtd">
+<reference xml:lang="en-us" id="rrefproperauthdn">
+<title>derby.authentication.ldap.searchAuthDN</title>
+<prolog><metadata>
+<keywords><indexterm>derby.authentication.ldap.searchAuthDN</indexterm>
+<indexterm>LDAP<indexterm>configuring</indexterm></indexterm>
+</keywords>
+</metadata>
+</prolog><refbody>
+<section><title>Function</title>
+<p>Along with
+<i><xref href="rrefproperauthpw.dita#rrefproperauthpw">derby.authentication.ldap.searchAuthPW</xref></i>,
+this property indicates how
+<ph conref="../conrefs.dita#prod/productshortname"></ph> should bind with the
+LDAP directory server to do searches for user DN (distinguished name). This
+property specifies the DN; <i>derby.authentication.ldap.searchAuthPW</i>
+specifies the password to use for the search.</p>
+<p>If these two properties are not specified, an anonymous search is performed
+if it is supported.</p> 
+<p>For more information about LDAP user authentication, see "LDAP directory
+service" in the <ph conref="../conrefs.dita#pub/citdevelop"></ph>.</p>
+</section>
+<refsyn><title>Syntax</title>
+<codeblock><b>derby.authentication.ldap.searchAuthDn=<i>DN</i></b></codeblock>
+</refsyn>
+<section><title>Default</title>
+<p>If not specified, an anonymous search is performed if it is supported.</p>
+</section>
+<example><title>Example</title>
+<codeblock><b><ph>-- system-wide property</ph>
+derby.authentication.ldap.searchAuthDn=
+    cn=guest,o=ExampleSite.com
+<ph>-- database-wide property</ph>
+CALL SYSCS_UTIL.SYSCS_SET_DATABASE_PROPERTY(
+    'derby.authentication.ldap.searchAuthDn',
+    'cn=guest,o=ExampleSite.com')</b></codeblock>
+</example>
+<section><title>Dynamic or static</title>
+<p>Static. For system-wide properties, you must reboot
+<ph conref="../conrefs.dita#prod/productshortname"></ph> for the change to take
+effect. For database-wide properties, you must reboot the database for the
+change to take effect.</p>
+</section></refbody></reference>

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

Added: db/derby/docs/trunk/src/ref/rrefproperauthpw.dita
URL: http://svn.apache.org/viewvc/db/derby/docs/trunk/src/ref/rrefproperauthpw.dita?rev=713746&view=auto
==============================================================================
--- db/derby/docs/trunk/src/ref/rrefproperauthpw.dita (added)
+++ db/derby/docs/trunk/src/ref/rrefproperauthpw.dita Thu Nov 13 08:09:44 2008
@@ -0,0 +1,59 @@
+<?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 reference PUBLIC "-//OASIS//DTD DITA Reference//EN"
+ "../dtd/reference.dtd">
+<reference id="rrefproperauthpw" xml:lang="en-us">
+<title>derby.authentication.ldap.searchAuthPW</title>
+<prolog><metadata>
+<keywords><indexterm>authentication.ldap.searchAuthPW</indexterm>
+<indexterm>LDAP<indexterm>configuring</indexterm></indexterm>
+</keywords>
+</metadata></prolog>
+<refbody>
+<section><title>Function</title>
+<p>Along with
+<i><xref href="rrefproperauthdn.dita#rrefproperauthdn">derby.authentication.ldap.searchAuthDN</xref></i>,
+indicates how <ph conref="../conrefs.dita#prod/productshortname"></ph> should
+bind with the directory server to do searches in order to retrieve a fully
+qualified user DN (distinguished name). This property specifies the password;
+<i>derby.authentication.ldap.searchAuthDN</i> specifies the DN to use for the
+search.</p>
+<p>For more information about LDAP user authentication, see "LDAP directory
+service" in the <ph conref="../conrefs.dita#pub/citdevelop"></ph>.</p>
+</section>
+<section><title>Default</title>
+<p>If not specified, an anonymous search is performed if it is supported.</p>
+</section>
+<example><title>Example</title>
+<codeblock><b><ph>-- system-wide property</ph>
+derby.authentication.ldap.searchAuthPW=guestPassword
+<ph>-- database-wide property</ph>
+CALL SYSCS_UTIL.SYSCS_SET_DATABASE_PROPERTY(
+    'derby.authentication.ldap.searchAuthPW',
+    'guestPassword')</b></codeblock>
+</example>
+<section><title>Dynamic or static</title>
+<p>Static. For system-wide properties, you must reboot
+<ph conref="../conrefs.dita#prod/productshortname"></ph> for the change to take
+effect. For database-wide properties, you must reboot the database for the
+change to take effect.</p>
+</section>
+</refbody>
+</reference>
+

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

Added: db/derby/docs/trunk/src/ref/rrefproperbootall.dita
URL: http://svn.apache.org/viewvc/db/derby/docs/trunk/src/ref/rrefproperbootall.dita?rev=713746&view=auto
==============================================================================
--- db/derby/docs/trunk/src/ref/rrefproperbootall.dita (added)
+++ db/derby/docs/trunk/src/ref/rrefproperbootall.dita Thu Nov 13 08:09:44 2008
@@ -0,0 +1,56 @@
+<?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 reference PUBLIC "-//OASIS//DTD DITA Reference//EN" "../dtd/reference.dtd">
+<reference xml:lang="en-us" id="rrefproperbootall">
+<title>derby.system.bootAll</title>
+<prolog><metadata>
+<keywords><indexterm>derby.system.bootAll</indexterm>
+<indexterm>databases<indexterm>configuring autobooting</indexterm></indexterm>
+</keywords>
+</metadata>
+</prolog><refbody>
+<section><title>Function</title>
+<p>Specifies that all databases in the directory specified by the
+<i><xref href="rrefproper32066.dita#rrefproper32066">derby.system.home</xref></i>
+property should be automatically booted at startup time.</p>
+<p>When this property is set to true, databases in the <i>derby.system.home</i>
+directory are booted at startup. Otherwise, databases are booted when you
+first connect to them.</p>
+<p>You may want to use the <i>derby.system.bootAll</i> property to avoid a
+delay at first connection time. After a crash, a boot that requires recovery
+can take a long time, and you may want to perform this boot as soon as
+<ph conref="../conrefs.dita#prod/productshortname"></ph> is restarted.</p>
+<p>You can set the <i>derby.database.noAutoBoot</i> property on a particular
+database if you want to prevent it from being automatically booted at startup.
+See <i><xref href="rrefpropernoautoboot.dita#rrefpropernoautoboot"/></i> for
+details.</p>
+</section>
+<section><title>Default</title>
+<p>False.</p>
+</section>
+<section><title>Scope</title>
+<p><xref href="crefproper51399.dita#crefproper51399/rrefproper41229">system-wide</xref></p>
+</section>
+<example><title>Example</title>
+<codeblock><b>derby.system.bootAll=true</b></codeblock>
+</example>
+<section><title>Dynamic or static</title>
+<p>This property is static; if you change it while 
+<ph conref="../conrefs.dita#prod/productshortname"></ph> is running, the change 
+does not take effect until you reboot.</p>
+</section></refbody></reference>

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

Added: db/derby/docs/trunk/src/ref/rrefpropercachedn.dita
URL: http://svn.apache.org/viewvc/db/derby/docs/trunk/src/ref/rrefpropercachedn.dita?rev=713746&view=auto
==============================================================================
--- db/derby/docs/trunk/src/ref/rrefpropercachedn.dita (added)
+++ db/derby/docs/trunk/src/ref/rrefpropercachedn.dita Thu Nov 13 08:09:44 2008
@@ -0,0 +1,34 @@
+<?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 reference PUBLIC "-//OASIS//DTD DITA Reference//EN" "../dtd/reference.dtd">
+<reference xml:lang="en-us" id="rrefpropercachedn">
+<title>Caching user DNs</title>
+<prolog>
+</prolog>
+<refbody>
+<section><p>This property caches user DNs (distinguished names) locally when
+<i><xref href="rrefproper13766.dita#rrefproper13766">derby.authentication.provider</xref></i>
+is set to <i>LDAP</i> and
+<i><xref href="rrefproper37341.dita#rrefproper37341">derby.authentication.ldap.searchFilter</xref></i>
+is set to <i>derby.user</i>. When you provide a user DN with this property,
+<ph conref="../conrefs.dita#prod/productshortname"></ph> is able to avoid an
+LDAP search for that user's DN before authenticating. For those users without
+DNs defined with this property,
+<ph conref="../conrefs.dita#prod/productshortname"></ph> performs a search using
+the default value of <i>derby.authentication.ldap.searchFilter</i>.</p>
+</section></refbody></reference>

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

Added: db/derby/docs/trunk/src/ref/rrefproperdurability.dita
URL: http://svn.apache.org/viewvc/db/derby/docs/trunk/src/ref/rrefproperdurability.dita?rev=713746&view=auto
==============================================================================
--- db/derby/docs/trunk/src/ref/rrefproperdurability.dita (added)
+++ db/derby/docs/trunk/src/ref/rrefproperdurability.dita Thu Nov 13 08:09:44 2008
@@ -0,0 +1,82 @@
+<?xml version="1.0" encoding="utf-8"?>
+<!DOCTYPE reference PUBLIC "-//OASIS//DTD DITA Reference//EN"
+ "../dtd/reference.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.
+-->
+<reference id="rrefproperdurability" xml:lang="en-us">
+<title>derby.system.durability</title>
+<prolog><metadata>
+<keywords><indexterm>derby.system.durability</indexterm></keywords>
+</metadata></prolog>
+<refbody>
+<section><title>Function</title>
+<p>This property changes the default durability of
+<ph conref="../conrefs.dita#prod/productshortname"></ph> to improve performance
+at the expense of consistency and durability of the database. The only valid
+supported case insensitive value is <codeph>test</codeph>. If this property is
+set to any value other than <codeph>test</codeph>, this property setting is
+ignored.  When <codeph>derby.system.durability</codeph> is set to
+<codeph>test</codeph>, the store system will not force I/O synchronization calls
+for:</p>
+<ul>
+<li>The log file at each commit</li>
+<li>The log file before a data page is forced to disk</li>
+<li>Page allocation when a file is grown</li>
+<li>Data writes during checkpoints</li>
+</ul>
+<p>While performance is improved, note that under these conditions, a commit no
+longer guarantees that the transaction's modification will survive a system
+crash or JVM termination, the database may not recover successfully upon
+restart, a near-full disk at runtime may cause unexpected errors, and the
+database may be in an inconsistent state.</p>
+<p>If you boot the database with this property set to <codeph>test</codeph>,
+the following warning message is logged in the
+<codeph>derby.log</codeph> file:</p>
+<codeblock>WARNING: The database is booted with derby.system.durability=test.
+In this mode, it is possible that database may not be able 
+to recover, committed transactions may be lost, and the database 
+may be in an inconsistent state. Please use this mode only when 
+these consequences are acceptable.</codeblock>
+<p>A similar message will appear in the <codeph>derby.log</codeph> file if the
+database was booted with <codeph>derby.system.durability=test</codeph> at any
+time previously.</p>
+<p>Once the database is booted with
+<codeph>derby.system.durability=test</codeph>, there are no guarantees that the
+database is consistent.</p>
+</section>
+<section><title>Default</title>
+<p>This property is ignored by default.</p>
+</section>
+<section><title>Supported values</title>
+<p>The only supported value is <codeph>test</codeph>.</p>
+</section>
+<example><title>Example</title>
+<codeblock><b>derby.system.durability=test</b></codeblock>
+<p>Since this is a system property, you can set it in the
+<codeph>derby.properties</codeph> file or on the command line of the JVM when
+starting the application.</p>
+<p>You might enable this property when using
+<ph conref="../conrefs.dita#prod/productshortname"></ph> as a test database
+where consistency or recoverability is not an issue.</p>
+</example>
+<section><title>Dynamic or static</title>
+<p>This property is static; if you change it while
+<ph conref="../conrefs.dita#prod/productshortname"></ph> is running, the change
+does not take effect until you reboot.</p>
+</section>
+</refbody>
+</reference>

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

Added: db/derby/docs/trunk/src/ref/rrefproperlogbuffersize.dita
URL: http://svn.apache.org/viewvc/db/derby/docs/trunk/src/ref/rrefproperlogbuffersize.dita?rev=713746&view=auto
==============================================================================
--- db/derby/docs/trunk/src/ref/rrefproperlogbuffersize.dita (added)
+++ db/derby/docs/trunk/src/ref/rrefproperlogbuffersize.dita Thu Nov 13 08:09:44 2008
@@ -0,0 +1,62 @@
+<?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 reference PUBLIC "-//OASIS//DTD DITA Reference//EN" "../dtd/reference.dtd">
+<reference xml:lang="en-us" id="rrefproperlogbuffersize">
+<title>derby.replication.logBufferSize</title>
+<prolog><metadata>
+<keywords><indexterm>derby.replication.logBufferSize</indexterm>
+<indexterm>replication<indexterm>specifying log buffer size</indexterm></indexterm>
+</keywords>
+</metadata>
+</prolog><refbody>
+<section><title>Function</title>
+<p>Specifies the size of the replication log buffers in bytes. These buffers
+store the log on the master side before it is shipped to the slave. There is a
+total of 10 such buffers. Large buffers increase memory usage but reduce
+the chance that the buffers will fill up (in turn increasing response time for
+transactions on the master, as described in the failure situation "The master
+<ph conref="../conrefs.dita#prod/productshortname"></ph> instance is not able
+to send log data to the slave at the same pace as the log is generated" in the
+topic "Replication failure handling" in the
+<ph conref="../conrefs.dita#pub/citadmin"></ph>).</p>
+<p>You can also use the properties
+<i><xref href="rrefproperminlogshippinginterval.dita#rrefproperminlogshippinginterval"></xref></i>
+and
+<i><xref href="rrefpropermaxlogshippinginterval.dita#rrefpropermaxlogshippinginterval"></xref></i>
+to tune the rate at which the log is shipped from the master to the slave.</p>
+</section>
+<section><title>Minimum value</title>
+<p>8192 (8 KB).</p>
+</section>
+<section><title>Maximum value</title>
+<p>The maximum value is 1048576 (1 MB).</p>
+</section>
+<section><title>Default</title>
+<p>32768 bytes (32KB).</p>
+</section>
+<example><title>Example</title>
+<codeblock><b>derby.replication.logBufferSize=65536</b></codeblock>
+</example>
+<section><title>Scope</title>
+<p><xref href="crefproper51399.dita#crefproper51399/rrefproper41229">system-wide</xref></p>
+</section>
+<section><title>Dynamic or static</title>
+<p>This property is static; if you change it while
+<ph conref="../conrefs.dita#prod/productshortname"></ph> is running, the change
+does not take effect until you reboot.</p>
+</section></refbody></reference>

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

Added: db/derby/docs/trunk/src/ref/rrefpropermaxlogshippinginterval.dita
URL: http://svn.apache.org/viewvc/db/derby/docs/trunk/src/ref/rrefpropermaxlogshippinginterval.dita?rev=713746&view=auto
==============================================================================
--- db/derby/docs/trunk/src/ref/rrefpropermaxlogshippinginterval.dita (added)
+++ db/derby/docs/trunk/src/ref/rrefpropermaxlogshippinginterval.dita Thu Nov 13 08:09:44 2008
@@ -0,0 +1,54 @@
+<?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 reference PUBLIC "-//OASIS//DTD DITA Reference//EN" "../dtd/reference.dtd">
+<reference xml:lang="en-us" id="rrefpropermaxlogshippinginterval">
+<title>derby.replication.maxLogShippingInterval</title>
+<prolog><metadata>
+<keywords><indexterm>derby.replication.maxLogShippingInterval</indexterm>
+<indexterm>replication<indexterm>specifying maximum log shipping interval</indexterm></indexterm>
+</keywords>
+</metadata>
+</prolog><refbody>
+<section><title>Function</title>
+<p>Specifies, in milliseconds, the longest interval between two consecutive
+shipments of the transaction log from the master to the slave. This property
+provides a "soft" guarantee that the slave will not deviate more than this
+number of milliseconds from the master.</p>
+<p>The value specified for the <i>derby.replication.maxLogShippingInterval</i>
+property must be at least ten times the value specified for the
+<i><xref href="rrefproperminlogshippinginterval.dita#rrefproperminlogshippinginterval"></xref></i>
+property. If you set <i>derby.replication.maxLogShippingInterval</i> to a lower
+value, <ph conref="../conrefs.dita#prod/productshortname"></ph> changes the
+<i><xref href="rrefproperminlogshippinginterval.dita#rrefproperminlogshippinginterval"></xref></i>
+property value to the value of the
+<i>derby.replication.maxLogShippingInterval</i> property divided by 10.</p>
+</section>
+<section><title>Default</title>
+<p>5000 milliseconds (5 seconds).</p>
+</section>
+<example><title>Example</title>
+<codeblock><b>derby.replication.maxLogShippingInterval=10000</b></codeblock>
+</example>
+<section><title>Scope</title>
+<p><xref href="crefproper51399.dita#crefproper51399/rrefproper41229">system-wide</xref></p>
+</section>
+<section><title>Dynamic or static</title>
+<p>This property is static; if you change it while
+<ph conref="../conrefs.dita#prod/productshortname"></ph> is running, the change
+does not take effect until you reboot.</p>
+</section></refbody></reference>

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

Added: db/derby/docs/trunk/src/ref/rrefproperminlogshippinginterval.dita
URL: http://svn.apache.org/viewvc/db/derby/docs/trunk/src/ref/rrefproperminlogshippinginterval.dita?rev=713746&view=auto
==============================================================================
--- db/derby/docs/trunk/src/ref/rrefproperminlogshippinginterval.dita (added)
+++ db/derby/docs/trunk/src/ref/rrefproperminlogshippinginterval.dita Thu Nov 13 08:09:44 2008
@@ -0,0 +1,53 @@
+<?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 reference PUBLIC "-//OASIS//DTD DITA Reference//EN" "../dtd/reference.dtd">
+<reference xml:lang="en-us" id="rrefproperminlogshippinginterval">
+<title>derby.replication.minLogShippingInterval</title>
+<prolog><metadata>
+<keywords><indexterm>derby.replication.minLogShippingInterval</indexterm>
+<indexterm>replication<indexterm>specifying minimum log shipping interval</indexterm></indexterm>
+</keywords>
+</metadata>
+</prolog><refbody>
+<section><title>Function</title>
+<p>Specifies, in milliseconds, the shortest interval between two consecutive
+shipments of the transaction log from the master to the slave.</p>
+<p>The value specified for the <i>derby.replication.minLogShippingInterval</i>
+property must be no more than one-tenth the value specified for the
+<i><xref href="rrefpropermaxlogshippinginterval.dita#rrefpropermaxlogshippinginterval"></xref></i>
+property. If you set <i>derby.replication.minLogShippingInterval</i> to a 
+higher value, <ph conref="../conrefs.dita#prod/productshortname"></ph> changes
+the <i>derby.replication.minLogShippingInterval</i> property value to the value
+of the
+<i><xref href="rrefpropermaxlogshippinginterval.dita#rrefpropermaxlogshippinginterval"></xref></i>
+property divided by 10.</p>
+</section>
+<section><title>Default</title>
+<p>100 milliseconds.</p>
+</section>
+<example><title>Example</title>
+<codeblock><b>derby.replication.minLogShippingInterval=500</b></codeblock>
+</example>
+<section><title>Scope</title>
+<p><xref href="crefproper51399.dita#crefproper51399/rrefproper41229">system-wide</xref></p>
+</section>
+<section><title>Dynamic or static</title>
+<p>This property is static; if you change it while
+<ph conref="../conrefs.dita#prod/productshortname"></ph> is running, the change
+does not take effect until you reboot.</p>
+</section></refbody></reference>

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

Added: db/derby/docs/trunk/src/ref/rrefpropernoautoboot.dita
URL: http://svn.apache.org/viewvc/db/derby/docs/trunk/src/ref/rrefpropernoautoboot.dita?rev=713746&view=auto
==============================================================================
--- db/derby/docs/trunk/src/ref/rrefpropernoautoboot.dita (added)
+++ db/derby/docs/trunk/src/ref/rrefpropernoautoboot.dita Thu Nov 13 08:09:44 2008
@@ -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 reference PUBLIC "-//OASIS//DTD DITA Reference//EN" "../dtd/reference.dtd">
+<reference xml:lang="en-us" id="rrefpropernoautoboot">
+<title>derby.database.noAutoBoot</title>
+<prolog><metadata>
+<keywords><indexterm>derby.database.noAutoBoot</indexterm>
+<indexterm>databases<indexterm>configuring autobooting</indexterm></indexterm>
+</keywords>
+</metadata>
+</prolog><refbody>
+<section><title>Function</title>
+<p>Specifies that a database should not be automatically booted at startup
+time.</p>
+<p>When this property is set to true, this database is booted only on the first
+connection. Otherwise, the database is booted at startup if the
+<i>derby.system.bootAll</i> property is set to true. See
+<i><xref href="rrefproperbootall.dita#rrefproperbootall"/></i> for details.</p>
+</section>
+<section><title>Default</title>
+<p>False.</p>
+</section>
+<refsyn><title>Example</title>
+<codeblock><b><ph>-- database-level property</ph>
+CALL SYSCS_UTIL.SYSCS_SET_DATABASE_PROPERTY(
+    'derby.database.noAutoBoot', 'true')</b></codeblock>
+</refsyn>
+<section><title>Scope</title>
+<p><xref href="crefproper51399.dita#crefproper51399/rrefproper15705">database-wide</xref></p>
+</section>
+<section><title>Dynamic or static</title>
+<p>This property is static; if you change it while 
+<ph conref="../conrefs.dita#prod/productshortname"></ph> is running, the change 
+does not take effect until you reboot.</p>
+</section>
+</refbody></reference>

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

Added: db/derby/docs/trunk/src/ref/rrefproperrowlocking.dita
URL: http://svn.apache.org/viewvc/db/derby/docs/trunk/src/ref/rrefproperrowlocking.dita?rev=713746&view=auto
==============================================================================
--- db/derby/docs/trunk/src/ref/rrefproperrowlocking.dita (added)
+++ db/derby/docs/trunk/src/ref/rrefproperrowlocking.dita Thu Nov 13 08:09:44 2008
@@ -0,0 +1,60 @@
+<?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 reference PUBLIC "-//OASIS//DTD DITA Reference//EN" "../dtd/reference.dtd">
+<reference xml:lang="en-us" id="rrefproperrowlocking">
+<title>derby.storage.rowLocking</title>
+<prolog><metadata>
+<keywords><indexterm>derby.storage.rowLocking</indexterm>
+<indexterm>databases<indexterm>configuring row-level locking</indexterm></indexterm>
+<indexterm>databases<indexterm>configuring table-level locking</indexterm></indexterm>
+<indexterm>lock granularity<indexterm>configuring</indexterm></indexterm>
+</keywords>
+</metadata>
+</prolog>
+<refbody>
+<section><title>Function</title>
+<p>If set to true, enables row-level locking. When you disable row-level
+locking, you use table-level locking.</p>
+<p>Row-level locking uses more system resources but allows greater concurrency,
+which works better in multi-user systems. Table-level locking works best with
+single-user applications or read-only applications.</p>
+<p>If you use row-level locking (the default), the system decides whether to
+use table-level locking or row-level locking for each table in each DML
+statement. In certain situations, the system might choose to escalate the
+locking scheme from row-level locking to table-level locking to improve
+performance.</p>
+<p>For more information about locking, see "Locking and performance"
+in <ph conref="../conrefs.dita#pub/cittuning"></ph>, and
+"Locking, concurrency, and isolation" in the
+<ph conref="../conrefs.dita#pub/citdevelop"></ph>.</p>
+</section>
+<section><title>Default</title>
+<p>True.</p></section>
+<refsyn><title>Example</title>
+<codeblock><b><ph>-- system-wide property</ph>
+derby.storage.rowLocking=false</b></codeblock>
+<codeblock><b><ph>-- database-level property</ph>
+CALL SYSCS_UTIL.SYSCS_SET_DATABASE_PROPERTY(
+    'derby.storage.rowLocking', 'false')</b></codeblock>
+</refsyn>
+<section><title>Dynamic or static</title>
+<p>This property is static; if you change it while 
+<ph conref="../conrefs.dita#prod/productshortname"></ph> is running, the change 
+does not take effect until you reboot.</p>
+</section>
+</refbody></reference>

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

Added: db/derby/docs/trunk/src/ref/rrefpropersqlauth.dita
URL: http://svn.apache.org/viewvc/db/derby/docs/trunk/src/ref/rrefpropersqlauth.dita?rev=713746&view=auto
==============================================================================
--- db/derby/docs/trunk/src/ref/rrefpropersqlauth.dita (added)
+++ db/derby/docs/trunk/src/ref/rrefpropersqlauth.dita Thu Nov 13 08:09:44 2008
@@ -0,0 +1,68 @@
+<?xml version="1.0" encoding="utf-8"?>
+ 
+<!DOCTYPE reference PUBLIC "-//OASIS//DTD DITA Reference//EN"
+ "../dtd/reference.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.-->
+<reference id="rrefpropersqlauth" xml:lang="en-us">
+<title>derby.database.sqlAuthorization</title>
+<prolog><metadata>
+<keywords><indexterm>derby.database.sqlAuthorization</indexterm>
+<indexterm>properties<indexterm>derby.database.sqlAuthorization</indexterm></indexterm>
+</keywords>
+</metadata></prolog>
+<refbody>
+<section><title>Function</title>
+<p>One of the user authorization properties.</p>
+<p>Enables the SQL standard authorization mode for the database or system on
+which this property is set. The possible values are:</p>
+<ul>
+<li><i>TRUE</i>   <p>SQL authorization for the database or system is enabled,
+which allows the use of GRANT and REVOKE statements.</p></li>
+<li><i>FALSE</i>   <p>SQL authorization for the database or system is disabled.
+After this property is set to TRUE, the property cannot be set back to
+FALSE.</p></li>
+</ul>
+<p>The values are not case-sensitive.</p>
+<note>If you set this property as a system property before you create the
+databases, all new databases will automatically have SQL authorization enabled.
+If the databases already exists, you can set this property only as a database
+property.</note>
+<p><ph conref="../conrefs.dita#prod/productshortname"></ph> uses the type of
+user authentication that is specified with the
+<codeph><xref href="rrefproper13766.dita#rrefproper13766">derby.authentication.provider</xref></codeph>
+property.</p>
+<p>For more information about user authorization, see "User authorizations" in
+the <ph conref="../conrefs.dita#pub/citdevelop"></ph>.</p>
+</section>
+<example><title>Example</title>
+<codeblock><b><ph>-- system-wide property</ph>
+derby.database.sqlAuthorization=true</b></codeblock>
+<codeblock><b><ph>-- database-level property</ph>
+CALL SYSCS_UTIL.SYSCS_SET_DATABASE_PROPERTY(
+    'derby.database.sqlAuthorization', 'true');</b></codeblock></example>
+<section><title>Default</title>
+<p><i>FALSE</i></p>
+</section>
+<section><title>Dynamic or static</title>
+<p>This property is static; if you change it while
+<ph conref="../conrefs.dita#prod/productshortname"></ph> is running, the change
+does not take effect until you reboot.</p>
+</section>
+</refbody>
+</reference>

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



Mime
View raw message