You are viewing a plain text version of this content. The canonical link for it is here.
Posted to derby-commits@db.apache.org by jt...@apache.org on 2005/03/31 02:27:30 UTC
svn commit: r159548 [14/17] - in incubator/derby/docs/trunk/src: adminguide/
devguide/ getstart/ tuning/
Modified: incubator/derby/docs/trunk/src/tuning/rtunproper26978.dita
URL: http://svn.apache.org/viewcvs/incubator/derby/docs/trunk/src/tuning/rtunproper26978.dita?view=diff&r1=159547&r2=159548
==============================================================================
--- incubator/derby/docs/trunk/src/tuning/rtunproper26978.dita (original)
+++ incubator/derby/docs/trunk/src/tuning/rtunproper26978.dita Wed Mar 30 16:26:36 2005
@@ -1,46 +1,46 @@
-<?xml version="1.0" encoding="utf-8"?>
-<!--
-Copyright 1997, 2004 The Apache Software Foundation or its licensors, as applicable.
-
-Licensed under the Apache License, Version 2.0 (the "License");
-you may not use this file except in compliance with the License.
-You may obtain a copy of the License at
-
-http://www.apache.org/licenses/LICENSE-2.0
-
-Unless required by applicable law or agreed to in writing, software
-distributed under the License is distributed on an "AS IS" BASIS,
-WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
-See the License for the specific language governing permissions and
-limitations under the License.
--->
-<!DOCTYPE reference PUBLIC "-//IBM//DTD DITA Reference//EN" "../dtd/reference.dtd">
-<reference xml:lang="en-us" id="rtunproper26978">
-<title>derby.authentication.ldap.searchBase</title>
-<prolog><metadata>
-<keywords><indexterm>derby.authentication.ldap.searchbase</indexterm><indexterm>LDAP<indexterm>configuring</indexterm></indexterm>
-</keywords>
-</metadata>
-</prolog><refbody>
-<section><title>Function</title>
-<p>Specifies the root DN of the point in your hierarchy from which to begin
-a guest or anonymous search for the user's DN. For example:
-<codeblock><b>ou=people,o=JBMSTours.com</b></codeblock></p>
-<p>When using Netscape Directory Server, set this property to the root DN,
-the special entry to which access control does not apply.</p>
-<p>For more information about LDAP user authentication, see the <cite><ph conref="tunconrefs.dita#pub/citdevelop"></ph>.</cite></p>
-</section>
-<example><title>Example</title>
-<codeblock><b><ph>-- system-wide property</ph>
-derby.authentication.ldap.searchBase=
- ou=people,o=JBMSTours.com
-<ph>-- database-wide property</ph>
-CALL SYSCS_UTIL.SYSCS_SET_DATABASE_PROPERTY(
- 'derby.authentication.ldap.searchBase',
- 'ou=people,o=JBMSTours.com')</b></codeblock>
-</example>
-<section><title>Dynamic or static</title>
-<p>Static. For system-wide properties, you must reboot <ph conref="tunconrefs.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>
+<?xml version="1.0" encoding="utf-8"?>
+<!--
+Copyright 1997, 2004 The Apache Software Foundation or its licensors, as applicable.
+
+Licensed under the Apache License, Version 2.0 (the "License");
+you may not use this file except in compliance with the License.
+You may obtain a copy of the License at
+
+http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing, software
+distributed under the License is distributed on an "AS IS" BASIS,
+WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+See the License for the specific language governing permissions and
+limitations under the License.
+-->
+<!DOCTYPE reference PUBLIC "-//IBM//DTD DITA Reference//EN" "../dtd/reference.dtd">
+<reference xml:lang="en-us" id="rtunproper26978">
+<title>derby.authentication.ldap.searchBase</title>
+<prolog><metadata>
+<keywords><indexterm>derby.authentication.ldap.searchbase</indexterm><indexterm>LDAP<indexterm>configuring</indexterm></indexterm>
+</keywords>
+</metadata>
+</prolog><refbody>
+<section><title>Function</title>
+<p>Specifies the root DN of the point in your hierarchy from which to begin
+a guest or anonymous search for the user's DN. For example:
+<codeblock><b>ou=people,o=JBMSTours.com</b></codeblock></p>
+<p>When using Netscape Directory Server, set this property to the root DN,
+the special entry to which access control does not apply.</p>
+<p>For more information about LDAP user authentication, see the <cite><ph conref="tunconrefs.dita#pub/citdevelop"></ph>.</cite></p>
+</section>
+<example><title>Example</title>
+<codeblock><b><ph>-- system-wide property</ph>
+derby.authentication.ldap.searchBase=
+ ou=people,o=JBMSTours.com
+<ph>-- database-wide property</ph>
+CALL SYSCS_UTIL.SYSCS_SET_DATABASE_PROPERTY(
+ 'derby.authentication.ldap.searchBase',
+ 'ou=people,o=JBMSTours.com')</b></codeblock>
+</example>
+<section><title>Dynamic or static</title>
+<p>Static. For system-wide properties, you must reboot <ph conref="tunconrefs.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: incubator/derby/docs/trunk/src/tuning/rtunproper26978.dita
------------------------------------------------------------------------------
svn:eol-style = native
Modified: incubator/derby/docs/trunk/src/tuning/rtunproper26985.dita
URL: http://svn.apache.org/viewcvs/incubator/derby/docs/trunk/src/tuning/rtunproper26985.dita?view=diff&r1=159547&r2=159548
==============================================================================
--- incubator/derby/docs/trunk/src/tuning/rtunproper26985.dita (original)
+++ incubator/derby/docs/trunk/src/tuning/rtunproper26985.dita Wed Mar 30 16:26:36 2005
@@ -1,58 +1,58 @@
-<?xml version="1.0" encoding="utf-8"?>
-<!--
-Copyright 1997, 2004 The Apache Software Foundation or its licensors, as applicable.
-
-Licensed under the Apache License, Version 2.0 (the "License");
-you may not use this file except in compliance with the License.
-You may obtain a copy of the License at
-
-http://www.apache.org/licenses/LICENSE-2.0
-
-Unless required by applicable law or agreed to in writing, software
-distributed under the License is distributed on an "AS IS" BASIS,
-WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
-See the License for the specific language governing permissions and
-limitations under the License.
--->
-<!DOCTYPE reference PUBLIC "-//IBM//DTD DITA Reference//EN" "../dtd/reference.dtd">
-<reference xml:lang="en-us" id="rtunproper26985">
-<title>derby.stream.error.logSeverityLevel</title>
-<prolog><metadata>
-<keywords><indexterm>derby.stream.error.logSeverityLevel</indexterm><indexterm>Error log<indexterm>configuring severity of errors
-that appear in</indexterm></indexterm>
-</keywords>
-</metadata>
-</prolog><refbody>
-<section><title>Function</title>
-<p>Specifies which errors are logged to the <ph conref="tunconrefs.dita#prod/productshortname"></ph> error log (typically
-the <i>derby.log</i> file). In test environments, use the
-setting <i>derby.stream.error.logSeverityLevel=0</i> so that
-all problems are reported.</p>
-<p>Any error raised in a <ph conref="tunconrefs.dita#prod/productshortname"></ph> system is given a level of severity.
-This property indicates the minimum severity necessary for an error to appear
-in the error log. The severities are defined in the class <i>org.apache.derby.types.ExceptionSeverity</i>. The higher the number, the more severe the error.
-<ul>
-<li><i>20000</i>
-<p>Errors that cause the statement to be
-rolled back, for example syntax errors and constraint violations.</p></li>
-<li><i>30000</i>
-<p>Errors that cause the transaction to
-be rolled back, for example deadlocks.</p></li>
-<li><i>40000</i>
-<p>Errors that cause the connection to
-be closed.</p></li>
-<li><i>50000</i>
-<p>Errors that shut down the <ph conref="tunconrefs.dita#prod/productshortname"></ph> system.</p></li>
-</ul></p>
-</section>
-<section><title>Default</title>
-<p>40000.</p>
-</section>
-<example><title>Example</title>
-<codeblock><b><ph>// send errors of level 30000 and higher to the log</ph>
-derby.stream.error.logSeverityLevel=30000</b></codeblock>
-</example>
-<section><title>Dynamic or static</title>
-<p>This property is static; if you change it while <ph conref="tunconrefs.dita#prod/productshortname"></ph> is running,
-the change does not take effect until you reboot.</p>
-</section></refbody></reference>
+<?xml version="1.0" encoding="utf-8"?>
+<!--
+Copyright 1997, 2004 The Apache Software Foundation or its licensors, as applicable.
+
+Licensed under the Apache License, Version 2.0 (the "License");
+you may not use this file except in compliance with the License.
+You may obtain a copy of the License at
+
+http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing, software
+distributed under the License is distributed on an "AS IS" BASIS,
+WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+See the License for the specific language governing permissions and
+limitations under the License.
+-->
+<!DOCTYPE reference PUBLIC "-//IBM//DTD DITA Reference//EN" "../dtd/reference.dtd">
+<reference xml:lang="en-us" id="rtunproper26985">
+<title>derby.stream.error.logSeverityLevel</title>
+<prolog><metadata>
+<keywords><indexterm>derby.stream.error.logSeverityLevel</indexterm><indexterm>Error log<indexterm>configuring severity of errors
+that appear in</indexterm></indexterm>
+</keywords>
+</metadata>
+</prolog><refbody>
+<section><title>Function</title>
+<p>Specifies which errors are logged to the <ph conref="tunconrefs.dita#prod/productshortname"></ph> error log (typically
+the <i>derby.log</i> file). In test environments, use the
+setting <i>derby.stream.error.logSeverityLevel=0</i> so that
+all problems are reported.</p>
+<p>Any error raised in a <ph conref="tunconrefs.dita#prod/productshortname"></ph> system is given a level of severity.
+This property indicates the minimum severity necessary for an error to appear
+in the error log. The severities are defined in the class <i>org.apache.derby.types.ExceptionSeverity</i>. The higher the number, the more severe the error.
+<ul>
+<li><i>20000</i>
+<p>Errors that cause the statement to be
+rolled back, for example syntax errors and constraint violations.</p></li>
+<li><i>30000</i>
+<p>Errors that cause the transaction to
+be rolled back, for example deadlocks.</p></li>
+<li><i>40000</i>
+<p>Errors that cause the connection to
+be closed.</p></li>
+<li><i>50000</i>
+<p>Errors that shut down the <ph conref="tunconrefs.dita#prod/productshortname"></ph> system.</p></li>
+</ul></p>
+</section>
+<section><title>Default</title>
+<p>40000.</p>
+</section>
+<example><title>Example</title>
+<codeblock><b><ph>// send errors of level 30000 and higher to the log</ph>
+derby.stream.error.logSeverityLevel=30000</b></codeblock>
+</example>
+<section><title>Dynamic or static</title>
+<p>This property is static; if you change it while <ph conref="tunconrefs.dita#prod/productshortname"></ph> is running,
+the change does not take effect until you reboot.</p>
+</section></refbody></reference>
Propchange: incubator/derby/docs/trunk/src/tuning/rtunproper26985.dita
------------------------------------------------------------------------------
svn:eol-style = native
Modified: incubator/derby/docs/trunk/src/tuning/rtunproper27355.dita
URL: http://svn.apache.org/viewcvs/incubator/derby/docs/trunk/src/tuning/rtunproper27355.dita?view=diff&r1=159547&r2=159548
==============================================================================
--- incubator/derby/docs/trunk/src/tuning/rtunproper27355.dita (original)
+++ incubator/derby/docs/trunk/src/tuning/rtunproper27355.dita Wed Mar 30 16:26:36 2005
@@ -1,78 +1,78 @@
-<?xml version="1.0" encoding="utf-8"?>
-<!--
-Copyright 1997, 2004 The Apache Software Foundation or its licensors, as applicable.
-
-Licensed under the Apache License, Version 2.0 (the "License");
-you may not use this file except in compliance with the License.
-You may obtain a copy of the License at
-
-http://www.apache.org/licenses/LICENSE-2.0
-
-Unless required by applicable law or agreed to in writing, software
-distributed under the License is distributed on an "AS IS" BASIS,
-WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
-See the License for the specific language governing permissions and
-limitations under the License.
--->
-
-<!DOCTYPE reference PUBLIC "-//IBM//DTD DITA Reference//EN"
- "../dtd/reference.dtd">
-<reference id="rtunproper27355" xml:lang="en-us">
-<title>derby.user.UserName</title><?Pub Caret1?>
-<prolog><metadata>
-<keywords><indexterm>derby.user</indexterm><indexterm>Users<indexterm>creating</indexterm></indexterm>
-</keywords>
-</metadata></prolog>
-<refbody>
-<section><title>Function</title> <p>Has two uses: <ul>
-<li>Creates users and passwords when <i><xref href="rtunproper13766.dita#rtunproper13766"></xref></i> is
-set to <i>BUILTIN.</i></li>
-<li>Caches user DNs locally when <i><xref href="rtunproper13766.dita#rtunproper13766"></xref></i> is
-set to <i>LDAP</i> and <i><xref href="rtunproper37341.dita#rtunproper37341"></xref></i> is
-set to <i>derby.user</i>.</li>
-</ul></p> </section>
-<section><title>Users and Passwords</title> <p>This property creates valid
-clear-text users and passwords within <ph conref="tunconrefs.dita#prod/productshortname"></ph> when
-the <i><xref href="rtunproper13766.dita#rtunproper13766"></xref></i> property
-is set to <i>BUILTIN</i>. For information about users, see "Working with User
-Authentication" in the <cite><ph conref="tunconrefs.dita#pub/citdevelop"></ph></cite>.
- <ul>
-<li><i>Database-Level Properties</i> <p>When you create users with database-level
-properties, those users are available to the specified database only.</p> <p>You
-set the property once for each user. To delete a user, set that user's password
-to null.</p></li>
-<li><i>System-Level Properties</i> <p>When you create users with system-level
-users, those users are available to all databases in the system.</p> <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.</p></li>
-</ul></p> <p>When a user name and its corresponding password are provided
-in the <i>DriverManager.getConnection</i> call, <ph conref="tunconrefs.dita#prod/productshortname"></ph> validates
-them against the properties defined for the current system.</p> <p>User names
-are <i>SQL92Identifiers</i> and can be delimited.</p> </section>
-<refsyn><title>Syntax</title> <codeblock><b>derby.user.{<b><i>UserName</i></b>=<b><i>Password</i></b>}<b><i> | UserName=userDN</i></b> }</b></codeblock
-> <codeblock><b><ph>-- database-level property</ph>
-CALL SYSCS_UTIL.SYSCS_SET_DATABASE_PROPERTY(
- 'derby.user.<b><i>UserName</i></b>',
- '<b><i>Password | userDN</i></b>')</b></codeblock> </refsyn>
-<section><title>Default</title> <p>None.</p> </section>
-<example><title>Example</title> <codeblock><b><ph>-- system-level property</ph>
-derby.user.guest=java5w</b></codeblock> <codeblock><b>derby.user.sa=<ph conref="tunconrefs.dita#prod/productshortname"></ph>3x9
-
-derby.user."!Amber"=java5w
-<ph>-- database-level property</ph>
-CALL SYSCS_UTIL.SYSCS_SET_DATABASE_PROPERTY(
- 'derby.user.sa',
- '<ph conref="tunconrefs.dita#prod/productshortname"></ph>3x9')<ph>-- cache a userDN locally</ph>
-derby.user.richard=uid=richard, ou=People, o=JBMSTours.com
-<ph>-- cache a userDN locally, database-level property</ph>
-CALL SYSCS_UTIL.SYSCS_SET_DATABASE_PROPERTY(
- 'derby.user.richard',
- 'uid=richard, ou=People, o=JBMSTours.com')
-</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="ctunsetprop44147.dita#ctunsetprop44147"></xref>.</p> </section>
-</refbody>
-</reference>
-<?Pub *0000003684?>
+<?xml version="1.0" encoding="utf-8"?>
+<!--
+Copyright 1997, 2004 The Apache Software Foundation or its licensors, as applicable.
+
+Licensed under the Apache License, Version 2.0 (the "License");
+you may not use this file except in compliance with the License.
+You may obtain a copy of the License at
+
+http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing, software
+distributed under the License is distributed on an "AS IS" BASIS,
+WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+See the License for the specific language governing permissions and
+limitations under the License.
+-->
+
+<!DOCTYPE reference PUBLIC "-//IBM//DTD DITA Reference//EN"
+ "../dtd/reference.dtd">
+<reference id="rtunproper27355" xml:lang="en-us">
+<title>derby.user.UserName</title><?Pub Caret1?>
+<prolog><metadata>
+<keywords><indexterm>derby.user</indexterm><indexterm>Users<indexterm>creating</indexterm></indexterm>
+</keywords>
+</metadata></prolog>
+<refbody>
+<section><title>Function</title> <p>Has two uses: <ul>
+<li>Creates users and passwords when <i><xref href="rtunproper13766.dita#rtunproper13766"></xref></i> is
+set to <i>BUILTIN.</i></li>
+<li>Caches user DNs locally when <i><xref href="rtunproper13766.dita#rtunproper13766"></xref></i> is
+set to <i>LDAP</i> and <i><xref href="rtunproper37341.dita#rtunproper37341"></xref></i> is
+set to <i>derby.user</i>.</li>
+</ul></p> </section>
+<section><title>Users and Passwords</title> <p>This property creates valid
+clear-text users and passwords within <ph conref="tunconrefs.dita#prod/productshortname"></ph> when
+the <i><xref href="rtunproper13766.dita#rtunproper13766"></xref></i> property
+is set to <i>BUILTIN</i>. For information about users, see "Working with User
+Authentication" in the <cite><ph conref="tunconrefs.dita#pub/citdevelop"></ph></cite>.
+ <ul>
+<li><i>Database-Level Properties</i> <p>When you create users with database-level
+properties, those users are available to the specified database only.</p> <p>You
+set the property once for each user. To delete a user, set that user's password
+to null.</p></li>
+<li><i>System-Level Properties</i> <p>When you create users with system-level
+users, those users are available to all databases in the system.</p> <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.</p></li>
+</ul></p> <p>When a user name and its corresponding password are provided
+in the <i>DriverManager.getConnection</i> call, <ph conref="tunconrefs.dita#prod/productshortname"></ph> validates
+them against the properties defined for the current system.</p> <p>User names
+are <i>SQL92Identifiers</i> and can be delimited.</p> </section>
+<refsyn><title>Syntax</title> <codeblock><b>derby.user.{<b><i>UserName</i></b>=<b><i>Password</i></b>}<b><i> | UserName=userDN</i></b> }</b></codeblock
+> <codeblock><b><ph>-- database-level property</ph>
+CALL SYSCS_UTIL.SYSCS_SET_DATABASE_PROPERTY(
+ 'derby.user.<b><i>UserName</i></b>',
+ '<b><i>Password | userDN</i></b>')</b></codeblock> </refsyn>
+<section><title>Default</title> <p>None.</p> </section>
+<example><title>Example</title> <codeblock><b><ph>-- system-level property</ph>
+derby.user.guest=java5w</b></codeblock> <codeblock><b>derby.user.sa=<ph conref="tunconrefs.dita#prod/productshortname"></ph>3x9
+
+derby.user."!Amber"=java5w
+<ph>-- database-level property</ph>
+CALL SYSCS_UTIL.SYSCS_SET_DATABASE_PROPERTY(
+ 'derby.user.sa',
+ '<ph conref="tunconrefs.dita#prod/productshortname"></ph>3x9')<ph>-- cache a userDN locally</ph>
+derby.user.richard=uid=richard, ou=People, o=JBMSTours.com
+<ph>-- cache a userDN locally, database-level property</ph>
+CALL SYSCS_UTIL.SYSCS_SET_DATABASE_PROPERTY(
+ 'derby.user.richard',
+ 'uid=richard, ou=People, o=JBMSTours.com')
+</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="ctunsetprop44147.dita#ctunsetprop44147"></xref>.</p> </section>
+</refbody>
+</reference>
+<?Pub *0000003684?>
Propchange: incubator/derby/docs/trunk/src/tuning/rtunproper27355.dita
------------------------------------------------------------------------------
svn:eol-style = native
Modified: incubator/derby/docs/trunk/src/tuning/rtunproper27467.dita
URL: http://svn.apache.org/viewcvs/incubator/derby/docs/trunk/src/tuning/rtunproper27467.dita?view=diff&r1=159547&r2=159548
==============================================================================
--- incubator/derby/docs/trunk/src/tuning/rtunproper27467.dita (original)
+++ incubator/derby/docs/trunk/src/tuning/rtunproper27467.dita Wed Mar 30 16:26:36 2005
@@ -1,49 +1,49 @@
-<?xml version="1.0" encoding="utf-8"?>
-<!--
-Copyright 1997, 2004 The Apache Software Foundation or its licensors, as applicable.
-
-Licensed under the Apache License, Version 2.0 (the "License");
-you may not use this file except in compliance with the License.
-You may obtain a copy of the License at
-
-http://www.apache.org/licenses/LICENSE-2.0
-
-Unless required by applicable law or agreed to in writing, software
-distributed under the License is distributed on an "AS IS" BASIS,
-WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
-See the License for the specific language governing permissions and
-limitations under the License.
--->
-<!DOCTYPE reference PUBLIC "-//IBM//DTD DITA Reference//EN" "../dtd/reference.dtd">
-<reference xml:lang="en-us" id="rtunproper27467">
-<title>derby.connection.requireAuthentication</title>
-<prolog><metadata>
-<keywords><indexterm>derby.connection.requireAuthentication</indexterm><indexterm>Authentication<indexterm>turning on</indexterm></indexterm><indexterm>User authentication<indexterm>turning on</indexterm></indexterm>
-</keywords>
-</metadata>
-</prolog><refbody>
-<section><title>Function</title>
-<p>Turns on user authentication for <ph conref="tunconrefs.dita#prod/productshortname"></ph>.</p>
-<p>When user authentication is turned on, a connection request must provide
-a valid user name and password.</p>
-<p><ph conref="tunconrefs.dita#prod/productshortname"></ph> uses the type of user authentication specified with the <i><xref href="rtunproper13766.dita#rtunproper13766"/></i> property.</p>
-<p>For more information about user authentication, see "Working with User
-Authentication" in Chapter 7 of the <cite><ph conref="tunconrefs.dita#pub/citdevelop"></ph></cite>.</p>
-</section>
-<section><title>Default</title>
-<p>False.</p>
-<p>By default, no user authentication is required.</p>
-</section>
-<example><title>Example</title>
-<codeblock><b><ph>-- system-wide property</ph>
-derby.connection.requireAuthentication=true
-<ph>-- database-wide property</ph>
-CALL SYSCS_UTIL.SYSCS_SET_DATABASE_PROPERTY(
- 'derby.connection.requireAuthentication',
- 'true')</b></codeblock>
-</example>
-<section><title>Dynamic or static</title>
-<p>Static. For system-wide properties, you must reboot <ph conref="tunconrefs.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>
+<?xml version="1.0" encoding="utf-8"?>
+<!--
+Copyright 1997, 2004 The Apache Software Foundation or its licensors, as applicable.
+
+Licensed under the Apache License, Version 2.0 (the "License");
+you may not use this file except in compliance with the License.
+You may obtain a copy of the License at
+
+http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing, software
+distributed under the License is distributed on an "AS IS" BASIS,
+WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+See the License for the specific language governing permissions and
+limitations under the License.
+-->
+<!DOCTYPE reference PUBLIC "-//IBM//DTD DITA Reference//EN" "../dtd/reference.dtd">
+<reference xml:lang="en-us" id="rtunproper27467">
+<title>derby.connection.requireAuthentication</title>
+<prolog><metadata>
+<keywords><indexterm>derby.connection.requireAuthentication</indexterm><indexterm>Authentication<indexterm>turning on</indexterm></indexterm><indexterm>User authentication<indexterm>turning on</indexterm></indexterm>
+</keywords>
+</metadata>
+</prolog><refbody>
+<section><title>Function</title>
+<p>Turns on user authentication for <ph conref="tunconrefs.dita#prod/productshortname"></ph>.</p>
+<p>When user authentication is turned on, a connection request must provide
+a valid user name and password.</p>
+<p><ph conref="tunconrefs.dita#prod/productshortname"></ph> uses the type of user authentication specified with the <i><xref href="rtunproper13766.dita#rtunproper13766"/></i> property.</p>
+<p>For more information about user authentication, see "Working with User
+Authentication" in Chapter 7 of the <cite><ph conref="tunconrefs.dita#pub/citdevelop"></ph></cite>.</p>
+</section>
+<section><title>Default</title>
+<p>False.</p>
+<p>By default, no user authentication is required.</p>
+</section>
+<example><title>Example</title>
+<codeblock><b><ph>-- system-wide property</ph>
+derby.connection.requireAuthentication=true
+<ph>-- database-wide property</ph>
+CALL SYSCS_UTIL.SYSCS_SET_DATABASE_PROPERTY(
+ 'derby.connection.requireAuthentication',
+ 'true')</b></codeblock>
+</example>
+<section><title>Dynamic or static</title>
+<p>Static. For system-wide properties, you must reboot <ph conref="tunconrefs.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: incubator/derby/docs/trunk/src/tuning/rtunproper27467.dita
------------------------------------------------------------------------------
svn:eol-style = native
Modified: incubator/derby/docs/trunk/src/tuning/rtunproper27529.dita
URL: http://svn.apache.org/viewcvs/incubator/derby/docs/trunk/src/tuning/rtunproper27529.dita?view=diff&r1=159547&r2=159548
==============================================================================
--- incubator/derby/docs/trunk/src/tuning/rtunproper27529.dita (original)
+++ incubator/derby/docs/trunk/src/tuning/rtunproper27529.dita Wed Mar 30 16:26:36 2005
@@ -1,62 +1,62 @@
-<?xml version="1.0" encoding="utf-8"?>
-<!--
-Copyright 1997, 2004 The Apache Software Foundation or its licensors, as applicable.
-
-Licensed under the Apache License, Version 2.0 (the "License");
-you may not use this file except in compliance with the License.
-You may obtain a copy of the License at
-
-http://www.apache.org/licenses/LICENSE-2.0
-
-Unless required by applicable law or agreed to in writing, software
-distributed under the License is distributed on an "AS IS" BASIS,
-WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
-See the License for the specific language governing permissions and
-limitations under the License.
--->
-<!DOCTYPE reference PUBLIC "-//IBM//DTD DITA Reference//EN" "../dtd/reference.dtd">
-<reference xml:lang="en-us" id="rtunproper27529">
-<title>derby.storage.initialPages</title>
-<prolog><metadata>
-<keywords><indexterm>derby.storage.initialPages</indexterm><indexterm>Database pages<indexterm>preallocating</indexterm></indexterm>
-</keywords>
-</metadata>
-</prolog><refbody>
-<section><title>Function</title>
-<p>The on-disk size of a <ph conref="tunconrefs.dita#prod/productshortname"></ph> table grows by one page at a time until
-eight pages of user data (or nine pages of total disk use, one is used for
-overhead) have been allocated. Then it will grow by eight pages at a time
-if possible.</p>
-<p>A <ph conref="tunconrefs.dita#prod/productshortname"></ph> table or index can be created with a number of pages already
-pre-allocated. To do so, specify the property prior to the CREATE TABLE or
-CREATE INDEX statement.</p>
-<p>Define the number of user pages the table or index is to be created with.
-The purpose of this property is to preallocate a table or index of reasonable
-size if the user expects that a large amount of data will be inserted into
-the table or index. A table or index that has the pre-allocated pages will
-enjoy a small performance improvement over a table or index that has no pre-allocated
-pages when the data are loaded.</p>
-<p>The total desired size of the table or index should be
-<codeblock><b>(1+derby.storage.initialPages) * derby.storage.pageSize bytes.</b></codeblock></p>
-<p>When you create a table or an index after setting this property, <ph conref="tunconrefs.dita#prod/productshortname"></ph>
-attempts to preallocate the requested number of user pages. However, the operations
-do not fail even if they are unable to preallocate the requested number of
-pages, as long as they allocate at least one page.</p>
-</section>
-<section><title>Default</title>
-<p>1 page.</p>
-</section>
-<section><title>Minimum value</title>
-<p>The minimum number of <i>initialPages</i> is 1. </p>
-</section>
-<section><title>Maximum value</title>
-<p>The maximum number of <i>initialPages</i> is 1000.</p>
-</section>
-<example><title>Example</title>
-<codeblock><b>-- system-wide property
-derby.storage.initialPages=30
-
--- database-wide property
-CALL SYSCS_UTIL.SYSCS_SET_DATABASE_PROPERTY(
-'derby.storage.initialPages', '30') </b></codeblock>
-</example></refbody></reference>
+<?xml version="1.0" encoding="utf-8"?>
+<!--
+Copyright 1997, 2004 The Apache Software Foundation or its licensors, as applicable.
+
+Licensed under the Apache License, Version 2.0 (the "License");
+you may not use this file except in compliance with the License.
+You may obtain a copy of the License at
+
+http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing, software
+distributed under the License is distributed on an "AS IS" BASIS,
+WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+See the License for the specific language governing permissions and
+limitations under the License.
+-->
+<!DOCTYPE reference PUBLIC "-//IBM//DTD DITA Reference//EN" "../dtd/reference.dtd">
+<reference xml:lang="en-us" id="rtunproper27529">
+<title>derby.storage.initialPages</title>
+<prolog><metadata>
+<keywords><indexterm>derby.storage.initialPages</indexterm><indexterm>Database pages<indexterm>preallocating</indexterm></indexterm>
+</keywords>
+</metadata>
+</prolog><refbody>
+<section><title>Function</title>
+<p>The on-disk size of a <ph conref="tunconrefs.dita#prod/productshortname"></ph> table grows by one page at a time until
+eight pages of user data (or nine pages of total disk use, one is used for
+overhead) have been allocated. Then it will grow by eight pages at a time
+if possible.</p>
+<p>A <ph conref="tunconrefs.dita#prod/productshortname"></ph> table or index can be created with a number of pages already
+pre-allocated. To do so, specify the property prior to the CREATE TABLE or
+CREATE INDEX statement.</p>
+<p>Define the number of user pages the table or index is to be created with.
+The purpose of this property is to preallocate a table or index of reasonable
+size if the user expects that a large amount of data will be inserted into
+the table or index. A table or index that has the pre-allocated pages will
+enjoy a small performance improvement over a table or index that has no pre-allocated
+pages when the data are loaded.</p>
+<p>The total desired size of the table or index should be
+<codeblock><b>(1+derby.storage.initialPages) * derby.storage.pageSize bytes.</b></codeblock></p>
+<p>When you create a table or an index after setting this property, <ph conref="tunconrefs.dita#prod/productshortname"></ph>
+attempts to preallocate the requested number of user pages. However, the operations
+do not fail even if they are unable to preallocate the requested number of
+pages, as long as they allocate at least one page.</p>
+</section>
+<section><title>Default</title>
+<p>1 page.</p>
+</section>
+<section><title>Minimum value</title>
+<p>The minimum number of <i>initialPages</i> is 1. </p>
+</section>
+<section><title>Maximum value</title>
+<p>The maximum number of <i>initialPages</i> is 1000.</p>
+</section>
+<example><title>Example</title>
+<codeblock><b>-- system-wide property
+derby.storage.initialPages=30
+
+-- database-wide property
+CALL SYSCS_UTIL.SYSCS_SET_DATABASE_PROPERTY(
+'derby.storage.initialPages', '30') </b></codeblock>
+</example></refbody></reference>
Propchange: incubator/derby/docs/trunk/src/tuning/rtunproper27529.dita
------------------------------------------------------------------------------
svn:eol-style = native
Modified: incubator/derby/docs/trunk/src/tuning/rtunproper28026.dita
URL: http://svn.apache.org/viewcvs/incubator/derby/docs/trunk/src/tuning/rtunproper28026.dita?view=diff&r1=159547&r2=159548
==============================================================================
--- incubator/derby/docs/trunk/src/tuning/rtunproper28026.dita (original)
+++ incubator/derby/docs/trunk/src/tuning/rtunproper28026.dita Wed Mar 30 16:26:36 2005
@@ -1,59 +1,59 @@
-<?xml version="1.0" encoding="utf-8"?>
-<!--
-Copyright 1997, 2004 The Apache Software Foundation or its licensors, as applicable.
-
-Licensed under the Apache License, Version 2.0 (the "License");
-you may not use this file except in compliance with the License.
-You may obtain a copy of the License at
-
-http://www.apache.org/licenses/LICENSE-2.0
-
-Unless required by applicable law or agreed to in writing, software
-distributed under the License is distributed on an "AS IS" BASIS,
-WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
-See the License for the specific language governing permissions and
-limitations under the License.
--->
-<!DOCTYPE reference PUBLIC "-//IBM//DTD DITA Reference//EN" "../dtd/reference.dtd">
-<reference xml:lang="en-us" id="rtunproper28026">
-<title>derby.storage.pageReservedSpace</title>
-<prolog><metadata>
-<keywords><indexterm>derby.storage.pageReservedSpace</indexterm><indexterm>Reserving space on a page</indexterm>
-</keywords>
-</metadata>
-</prolog><refbody>
-<section><title>Function</title>
-<p>Defines the percentage of space reserved for updates on an on-disk database
-page for tables only (not indexes); indicates the percentage of space to keep
-free on a page when inserting. Leaving reserved space on a page can minimize
-row overflow (and the associated performance hit) during updates. Once a page
-has been filled up to the reserved-space threshold, no new rows are allowed
-on the page. This reserved space is used only for rows that increase in size
-when updated, not for new inserts. Set this property prior to issuing the
-CREATE TABLE statement.</p>
-<p>Regardless of the value of <i>derby.storage.pageReservedSpace</i>, an empty page always accepts at least one row.</p>
-</section>
-<section><title>Valid conglomerates</title>
-<p>Tables only.</p>
-</section>
-<section><title>Default</title>
-<p id="rtunproper42041">20%.</p>
-</section>
-<section><title>Minimum value</title>
-<p>The minimum value is 0% and the maximum is 100%. If you specify a value
-outside this range, <ph conref="tunconrefs.dita#prod/productshortname"></ph> uses the default value of 20%. </p>
-</section>
-<example><title>Example</title>
-<codeblock><b><ph>-- modifying the default for the system</ph>
-derby.storage.pageReservedSpace=40
-<ph>-- modifying the default for the database</ph>
-CALL SYSCS_UTIL.SYSCS_SET_DATABASE_PROPERTY(
- 'derby.storage.pageReservedSpace',
- '40')
-</b></codeblock>
-</example>
-<section><title>Dynamic or static</title>
-<p>This property is dynamic; if you change it while <ph conref="tunconrefs.dita#prod/productshortname"></ph> is running,
-the change takes effect immediately. For information about dynamic changes
-to properties, see <xref href="ctunsetprop44147.dita#ctunsetprop44147"/>.</p>
-</section></refbody></reference>
+<?xml version="1.0" encoding="utf-8"?>
+<!--
+Copyright 1997, 2004 The Apache Software Foundation or its licensors, as applicable.
+
+Licensed under the Apache License, Version 2.0 (the "License");
+you may not use this file except in compliance with the License.
+You may obtain a copy of the License at
+
+http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing, software
+distributed under the License is distributed on an "AS IS" BASIS,
+WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+See the License for the specific language governing permissions and
+limitations under the License.
+-->
+<!DOCTYPE reference PUBLIC "-//IBM//DTD DITA Reference//EN" "../dtd/reference.dtd">
+<reference xml:lang="en-us" id="rtunproper28026">
+<title>derby.storage.pageReservedSpace</title>
+<prolog><metadata>
+<keywords><indexterm>derby.storage.pageReservedSpace</indexterm><indexterm>Reserving space on a page</indexterm>
+</keywords>
+</metadata>
+</prolog><refbody>
+<section><title>Function</title>
+<p>Defines the percentage of space reserved for updates on an on-disk database
+page for tables only (not indexes); indicates the percentage of space to keep
+free on a page when inserting. Leaving reserved space on a page can minimize
+row overflow (and the associated performance hit) during updates. Once a page
+has been filled up to the reserved-space threshold, no new rows are allowed
+on the page. This reserved space is used only for rows that increase in size
+when updated, not for new inserts. Set this property prior to issuing the
+CREATE TABLE statement.</p>
+<p>Regardless of the value of <i>derby.storage.pageReservedSpace</i>, an empty page always accepts at least one row.</p>
+</section>
+<section><title>Valid conglomerates</title>
+<p>Tables only.</p>
+</section>
+<section><title>Default</title>
+<p id="rtunproper42041">20%.</p>
+</section>
+<section><title>Minimum value</title>
+<p>The minimum value is 0% and the maximum is 100%. If you specify a value
+outside this range, <ph conref="tunconrefs.dita#prod/productshortname"></ph> uses the default value of 20%. </p>
+</section>
+<example><title>Example</title>
+<codeblock><b><ph>-- modifying the default for the system</ph>
+derby.storage.pageReservedSpace=40
+<ph>-- modifying the default for the database</ph>
+CALL SYSCS_UTIL.SYSCS_SET_DATABASE_PROPERTY(
+ 'derby.storage.pageReservedSpace',
+ '40')
+</b></codeblock>
+</example>
+<section><title>Dynamic or static</title>
+<p>This property is dynamic; if you change it while <ph conref="tunconrefs.dita#prod/productshortname"></ph> is running,
+the change takes effect immediately. For information about dynamic changes
+to properties, see <xref href="ctunsetprop44147.dita#ctunsetprop44147"/>.</p>
+</section></refbody></reference>
Propchange: incubator/derby/docs/trunk/src/tuning/rtunproper28026.dita
------------------------------------------------------------------------------
svn:eol-style = native
Modified: incubator/derby/docs/trunk/src/tuning/rtunproper32066.dita
URL: http://svn.apache.org/viewcvs/incubator/derby/docs/trunk/src/tuning/rtunproper32066.dita?view=diff&r1=159547&r2=159548
==============================================================================
--- incubator/derby/docs/trunk/src/tuning/rtunproper32066.dita (original)
+++ incubator/derby/docs/trunk/src/tuning/rtunproper32066.dita Wed Mar 30 16:26:36 2005
@@ -1,43 +1,43 @@
-<?xml version="1.0" encoding="utf-8"?>
-<!--
-Copyright 1997, 2004 The Apache Software Foundation or its licensors, as applicable.
-
-Licensed under the Apache License, Version 2.0 (the "License");
-you may not use this file except in compliance with the License.
-You may obtain a copy of the License at
-
-http://www.apache.org/licenses/LICENSE-2.0
-
-Unless required by applicable law or agreed to in writing, software
-distributed under the License is distributed on an "AS IS" BASIS,
-WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
-See the License for the specific language governing permissions and
-limitations under the License.
--->
-<!DOCTYPE reference PUBLIC "-//IBM//DTD DITA Reference//EN" "../dtd/reference.dtd">
-<reference xml:lang="en-us" id="rtunproper32066">
-<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="tunconrefs.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="tunconrefs.dita#prod/productshortname"></ph> creates the directory automatically.</p>
-</section>
-<section><title>Default</title>
-<p id="rtunproper11779">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="tunconrefs.dita#prod/productshortname"></ph>, the default is the directory in
-which <ph conref="tunconrefs.dita#prod/productshortname"></ph> was started.
-<note>You should always explicitly
-set the value of <i>derby.system.home</i>.</note></p>
-</section>
-<example><title>Example</title>
-<codeblock><b>-Dderby.system.home=C:\<ph conref="tunconrefs.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="tunconrefs.dita#prod/productshortname"></ph> is running,
-the change does not take effect until you reboot.</p>
-</section></refbody></reference>
+<?xml version="1.0" encoding="utf-8"?>
+<!--
+Copyright 1997, 2004 The Apache Software Foundation or its licensors, as applicable.
+
+Licensed under the Apache License, Version 2.0 (the "License");
+you may not use this file except in compliance with the License.
+You may obtain a copy of the License at
+
+http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing, software
+distributed under the License is distributed on an "AS IS" BASIS,
+WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+See the License for the specific language governing permissions and
+limitations under the License.
+-->
+<!DOCTYPE reference PUBLIC "-//IBM//DTD DITA Reference//EN" "../dtd/reference.dtd">
+<reference xml:lang="en-us" id="rtunproper32066">
+<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="tunconrefs.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="tunconrefs.dita#prod/productshortname"></ph> creates the directory automatically.</p>
+</section>
+<section><title>Default</title>
+<p id="rtunproper11779">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="tunconrefs.dita#prod/productshortname"></ph>, the default is the directory in
+which <ph conref="tunconrefs.dita#prod/productshortname"></ph> was started.
+<note>You should always explicitly
+set the value of <i>derby.system.home</i>.</note></p>
+</section>
+<example><title>Example</title>
+<codeblock><b>-Dderby.system.home=C:\<ph conref="tunconrefs.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="tunconrefs.dita#prod/productshortname"></ph> is running,
+the change does not take effect until you reboot.</p>
+</section></refbody></reference>
Propchange: incubator/derby/docs/trunk/src/tuning/rtunproper32066.dita
------------------------------------------------------------------------------
svn:eol-style = native
Modified: incubator/derby/docs/trunk/src/tuning/rtunproper32213.dita
URL: http://svn.apache.org/viewcvs/incubator/derby/docs/trunk/src/tuning/rtunproper32213.dita?view=diff&r1=159547&r2=159548
==============================================================================
--- incubator/derby/docs/trunk/src/tuning/rtunproper32213.dita (original)
+++ incubator/derby/docs/trunk/src/tuning/rtunproper32213.dita Wed Mar 30 16:26:36 2005
@@ -1,23 +1,23 @@
-<?xml version="1.0" encoding="utf-8"?>
-<!--
-Copyright 1997, 2004 The Apache Software Foundation or its licensors, as applicable.
-
-Licensed under the Apache License, Version 2.0 (the "License");
-you may not use this file except in compliance with the License.
-You may obtain a copy of the License at
-
-http://www.apache.org/licenses/LICENSE-2.0
-
-Unless required by applicable law or agreed to in writing, software
-distributed under the License is distributed on an "AS IS" BASIS,
-WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
-See the License for the specific language governing permissions and
-limitations under the License.
--->
-<!DOCTYPE reference PUBLIC "-//IBM//DTD DITA Reference//EN" "../dtd/reference.dtd">
-<reference xml:lang="en-us" id="rtunproper32213">
-<title>Derby properties</title>
-<prolog>
-</prolog>
-<refbody>
-</refbody></reference>
+<?xml version="1.0" encoding="utf-8"?>
+<!--
+Copyright 1997, 2004 The Apache Software Foundation or its licensors, as applicable.
+
+Licensed under the Apache License, Version 2.0 (the "License");
+you may not use this file except in compliance with the License.
+You may obtain a copy of the License at
+
+http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing, software
+distributed under the License is distributed on an "AS IS" BASIS,
+WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+See the License for the specific language governing permissions and
+limitations under the License.
+-->
+<!DOCTYPE reference PUBLIC "-//IBM//DTD DITA Reference//EN" "../dtd/reference.dtd">
+<reference xml:lang="en-us" id="rtunproper32213">
+<title>Derby properties</title>
+<prolog>
+</prolog>
+<refbody>
+</refbody></reference>
Propchange: incubator/derby/docs/trunk/src/tuning/rtunproper32213.dita
------------------------------------------------------------------------------
svn:eol-style = native
Modified: incubator/derby/docs/trunk/src/tuning/rtunproper33027.dita
URL: http://svn.apache.org/viewcvs/incubator/derby/docs/trunk/src/tuning/rtunproper33027.dita?view=diff&r1=159547&r2=159548
==============================================================================
--- incubator/derby/docs/trunk/src/tuning/rtunproper33027.dita (original)
+++ incubator/derby/docs/trunk/src/tuning/rtunproper33027.dita Wed Mar 30 16:26:36 2005
@@ -1,45 +1,45 @@
-<?xml version="1.0" encoding="utf-8"?>
-<!--
-Copyright 1997, 2004 The Apache Software Foundation or its licensors, as applicable.
-
-Licensed under the Apache License, Version 2.0 (the "License");
-you may not use this file except in compliance with the License.
-You may obtain a copy of the License at
-
-http://www.apache.org/licenses/LICENSE-2.0
-
-Unless required by applicable law or agreed to in writing, software
-distributed under the License is distributed on an "AS IS" BASIS,
-WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
-See the License for the specific language governing permissions and
-limitations under the License.
--->
-<!DOCTYPE reference PUBLIC "-//IBM//DTD DITA Reference//EN" "../dtd/reference.dtd">
-<reference xml:lang="en-us" id="rtunproper33027">
-<title>derby.stream.error.field<ph><indexterm>derby.stream.error.field</indexterm></ph><ph><indexterm>Error log<indexterm>redirecting to a stream</indexterm></indexterm></ph></title>
-<prolog>
-</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="tunconrefs.dita#prod/productshortname"></ph> boot time, and the value is used
-until <ph conref="tunconrefs.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="tunconrefs.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="ctunproper51399.dita#ctunproper51399/rtunproper41229">system-wide</xref></p>
-</section>
-<section><title>Dynamic or static</title>
-<p>This property is static; if you change it while <ph conref="tunconrefs.dita#prod/productshortname"></ph> is running,
-the change does not take effect until you reboot.</p>
-</section></refbody></reference>
+<?xml version="1.0" encoding="utf-8"?>
+<!--
+Copyright 1997, 2004 The Apache Software Foundation or its licensors, as applicable.
+
+Licensed under the Apache License, Version 2.0 (the "License");
+you may not use this file except in compliance with the License.
+You may obtain a copy of the License at
+
+http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing, software
+distributed under the License is distributed on an "AS IS" BASIS,
+WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+See the License for the specific language governing permissions and
+limitations under the License.
+-->
+<!DOCTYPE reference PUBLIC "-//IBM//DTD DITA Reference//EN" "../dtd/reference.dtd">
+<reference xml:lang="en-us" id="rtunproper33027">
+<title>derby.stream.error.field<ph><indexterm>derby.stream.error.field</indexterm></ph><ph><indexterm>Error log<indexterm>redirecting to a stream</indexterm></indexterm></ph></title>
+<prolog>
+</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="tunconrefs.dita#prod/productshortname"></ph> boot time, and the value is used
+until <ph conref="tunconrefs.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="tunconrefs.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="ctunproper51399.dita#ctunproper51399/rtunproper41229">system-wide</xref></p>
+</section>
+<section><title>Dynamic or static</title>
+<p>This property is static; if you change it while <ph conref="tunconrefs.dita#prod/productshortname"></ph> is running,
+the change does not take effect until you reboot.</p>
+</section></refbody></reference>
Propchange: incubator/derby/docs/trunk/src/tuning/rtunproper33027.dita
------------------------------------------------------------------------------
svn:eol-style = native
Modified: incubator/derby/docs/trunk/src/tuning/rtunproper34037.dita
URL: http://svn.apache.org/viewcvs/incubator/derby/docs/trunk/src/tuning/rtunproper34037.dita?view=diff&r1=159547&r2=159548
==============================================================================
--- incubator/derby/docs/trunk/src/tuning/rtunproper34037.dita (original)
+++ incubator/derby/docs/trunk/src/tuning/rtunproper34037.dita Wed Mar 30 16:26:36 2005
@@ -1,66 +1,66 @@
-<?xml version="1.0" encoding="utf-8"?>
-<!--
-Copyright 1997, 2004 The Apache Software Foundation or its licensors, as applicable.
-
-Licensed under the Apache License, Version 2.0 (the "License");
-you may not use this file except in compliance with the License.
-You may obtain a copy of the License at
-
-http://www.apache.org/licenses/LICENSE-2.0
-
-Unless required by applicable law or agreed to in writing, software
-distributed under the License is distributed on an "AS IS" BASIS,
-WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
-See the License for the specific language governing permissions and
-limitations under the License.
--->
-<!DOCTYPE reference PUBLIC "-//IBM//DTD DITA Reference//EN" "../dtd/reference.dtd">
-<reference xml:lang="en-us" id="rtunproper34037">
-<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="tunconrefs.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:
-<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>
-<p>This property moves the temporary directories for all databases being used
-by the <ph conref="tunconrefs.dita#prod/productshortname"></ph> system. <ph conref="tunconrefs.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:
-<codeblock><b>derby.storage.tempDirectory=C:/Temp/dbtemp</b></codeblock></p>
-<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 (e.g.,<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 id="rtunproper14048">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="tunconrefs.dita#prod/productshortname"></ph> for a change to take
-effect.</p>
-</section></refbody></reference>
+<?xml version="1.0" encoding="utf-8"?>
+<!--
+Copyright 1997, 2004 The Apache Software Foundation or its licensors, as applicable.
+
+Licensed under the Apache License, Version 2.0 (the "License");
+you may not use this file except in compliance with the License.
+You may obtain a copy of the License at
+
+http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing, software
+distributed under the License is distributed on an "AS IS" BASIS,
+WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+See the License for the specific language governing permissions and
+limitations under the License.
+-->
+<!DOCTYPE reference PUBLIC "-//IBM//DTD DITA Reference//EN" "../dtd/reference.dtd">
+<reference xml:lang="en-us" id="rtunproper34037">
+<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="tunconrefs.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:
+<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>
+<p>This property moves the temporary directories for all databases being used
+by the <ph conref="tunconrefs.dita#prod/productshortname"></ph> system. <ph conref="tunconrefs.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:
+<codeblock><b>derby.storage.tempDirectory=C:/Temp/dbtemp</b></codeblock></p>
+<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 (e.g.,<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 id="rtunproper14048">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="tunconrefs.dita#prod/productshortname"></ph> for a change to take
+effect.</p>
+</section></refbody></reference>
Propchange: incubator/derby/docs/trunk/src/tuning/rtunproper34037.dita
------------------------------------------------------------------------------
svn:eol-style = native
Modified: incubator/derby/docs/trunk/src/tuning/rtunproper35028.dita
URL: http://svn.apache.org/viewcvs/incubator/derby/docs/trunk/src/tuning/rtunproper35028.dita?view=diff&r1=159547&r2=159548
==============================================================================
--- incubator/derby/docs/trunk/src/tuning/rtunproper35028.dita (original)
+++ incubator/derby/docs/trunk/src/tuning/rtunproper35028.dita Wed Mar 30 16:26:36 2005
@@ -1,47 +1,47 @@
-<?xml version="1.0" encoding="utf-8"?>
-<!--
-Copyright 1997, 2004 The Apache Software Foundation or its licensors, as applicable.
-
-Licensed under the Apache License, Version 2.0 (the "License");
-you may not use this file except in compliance with the License.
-You may obtain a copy of the License at
-
-http://www.apache.org/licenses/LICENSE-2.0
-
-Unless required by applicable law or agreed to in writing, software
-distributed under the License is distributed on an "AS IS" BASIS,
-WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
-See the License for the specific language governing permissions and
-limitations under the License.
--->
-<!DOCTYPE reference PUBLIC "-//IBM//DTD DITA Reference//EN" "../dtd/reference.dtd">
-<reference xml:lang="en-us" id="rtunproper35028">
-<title>derby.stream.error.method<ph><indexterm>derby.stream.error.method</indexterm></ph><ph><indexterm>Error log<indexterm>redirecting to a stream</indexterm></indexterm></ph></title>
-<prolog>
-</prolog><refbody>
-<section><title>Function</title>
-<p>Specifies a static method that returns a stream to which the <ph conref="tunconrefs.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="tunconrefs.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="tunconrefs.dita#prod/productshortname"></ph> boot time, and the return value
-is used for the lifetime of <ph conref="tunconrefs.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="ctunproper51399.dita#ctunproper51399/rtunproper41229">system-wide</xref></p>
-</section>
-<section><title>Dynamic or static</title>
-<p>This property is static; if you change it while <ph conref="tunconrefs.dita#prod/productshortname"></ph> is running,
-the change does not take effect until you reboot.</p>
-</section></refbody></reference>
+<?xml version="1.0" encoding="utf-8"?>
+<!--
+Copyright 1997, 2004 The Apache Software Foundation or its licensors, as applicable.
+
+Licensed under the Apache License, Version 2.0 (the "License");
+you may not use this file except in compliance with the License.
+You may obtain a copy of the License at
+
+http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing, software
+distributed under the License is distributed on an "AS IS" BASIS,
+WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+See the License for the specific language governing permissions and
+limitations under the License.
+-->
+<!DOCTYPE reference PUBLIC "-//IBM//DTD DITA Reference//EN" "../dtd/reference.dtd">
+<reference xml:lang="en-us" id="rtunproper35028">
+<title>derby.stream.error.method<ph><indexterm>derby.stream.error.method</indexterm></ph><ph><indexterm>Error log<indexterm>redirecting to a stream</indexterm></indexterm></ph></title>
+<prolog>
+</prolog><refbody>
+<section><title>Function</title>
+<p>Specifies a static method that returns a stream to which the <ph conref="tunconrefs.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="tunconrefs.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="tunconrefs.dita#prod/productshortname"></ph> boot time, and the return value
+is used for the lifetime of <ph conref="tunconrefs.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="ctunproper51399.dita#ctunproper51399/rtunproper41229">system-wide</xref></p>
+</section>
+<section><title>Dynamic or static</title>
+<p>This property is static; if you change it while <ph conref="tunconrefs.dita#prod/productshortname"></ph> is running,
+the change does not take effect until you reboot.</p>
+</section></refbody></reference>
Propchange: incubator/derby/docs/trunk/src/tuning/rtunproper35028.dita
------------------------------------------------------------------------------
svn:eol-style = native
Modified: incubator/derby/docs/trunk/src/tuning/rtunproper37341.dita
URL: http://svn.apache.org/viewcvs/incubator/derby/docs/trunk/src/tuning/rtunproper37341.dita?view=diff&r1=159547&r2=159548
==============================================================================
--- incubator/derby/docs/trunk/src/tuning/rtunproper37341.dita (original)
+++ incubator/derby/docs/trunk/src/tuning/rtunproper37341.dita Wed Mar 30 16:26:36 2005
@@ -1,72 +1,72 @@
-<?xml version="1.0" encoding="utf-8"?>
-<!--
-Copyright 1997, 2004 The Apache Software Foundation or its licensors, as applicable.
-
-Licensed under the Apache License, Version 2.0 (the "License");
-you may not use this file except in compliance with the License.
-You may obtain a copy of the License at
-
-http://www.apache.org/licenses/LICENSE-2.0
-
-Unless required by applicable law or agreed to in writing, software
-distributed under the License is distributed on an "AS IS" BASIS,
-WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
-See the License for the specific language governing permissions and
-limitations under the License.
--->
-<!DOCTYPE reference PUBLIC "-//IBM//DTD DITA Reference//EN" "../dtd/reference.dtd">
-<reference xml:lang="en-us" id="rtunproper37341">
-<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="tunconrefs.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="tunconrefs.dita#prod/productshortname"></ph> looks
-for cached full DNs for users that you have defined with the <i><xref href="rtunproper27355.dita#rtunproper27355"/></i> property. For other users, <ph conref="tunconrefs.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 Chapter 7 of the <cite><ph conref="tunconrefs.dita#pub/citdevelop"></ph>.</cite></p>
-</section>
-<refsyn><title>Syntax</title>
-<codeblock><b>derby.authentication.ldap.searchFilter=
- {<b><i> searchFilter </i></b>| derby.user)</b></codeblock>
-</refsyn>
-<section><title>Default</title>
-<codeblock><b>(&(objectClass=inetOrgPerson)(uid=<b><i>userName</i></b>))</b></codeblock>
-<note><ph conref="tunconrefs.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="tunconrefs.dita#prod/productshortname"></ph> automatically adds (uid=<userName>)</ph>
-derby.authentication.ldap.searchFilter=(&(ou=Marketing)
- (objectClass=person))
-<ph>## all people but those in marketing
-## <ph conref="tunconrefs.dita#prod/productshortname"></ph> automatically adds (uid=<userName>)</ph>
-derby.authentication.ldap.searchFilter=(&(!(ou=Marketing)
- (objectClass=person))
-<ph>## map %USERNAME% to user, not <i>uid</i></ph>
-derby.authentication.ldap.searchFilter=(&((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="tunconrefs.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>
+<?xml version="1.0" encoding="utf-8"?>
+<!--
+Copyright 1997, 2004 The Apache Software Foundation or its licensors, as applicable.
+
+Licensed under the Apache License, Version 2.0 (the "License");
+you may not use this file except in compliance with the License.
+You may obtain a copy of the License at
+
+http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing, software
+distributed under the License is distributed on an "AS IS" BASIS,
+WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+See the License for the specific language governing permissions and
+limitations under the License.
+-->
+<!DOCTYPE reference PUBLIC "-//IBM//DTD DITA Reference//EN" "../dtd/reference.dtd">
+<reference xml:lang="en-us" id="rtunproper37341">
+<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="tunconrefs.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="tunconrefs.dita#prod/productshortname"></ph> looks
+for cached full DNs for users that you have defined with the <i><xref href="rtunproper27355.dita#rtunproper27355"/></i> property. For other users, <ph conref="tunconrefs.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 Chapter 7 of the <cite><ph conref="tunconrefs.dita#pub/citdevelop"></ph>.</cite></p>
+</section>
+<refsyn><title>Syntax</title>
+<codeblock><b>derby.authentication.ldap.searchFilter=
+ {<b><i> searchFilter </i></b>| derby.user)</b></codeblock>
+</refsyn>
+<section><title>Default</title>
+<codeblock><b>(&(objectClass=inetOrgPerson)(uid=<b><i>userName</i></b>))</b></codeblock>
+<note><ph conref="tunconrefs.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="tunconrefs.dita#prod/productshortname"></ph> automatically adds (uid=<userName>)</ph>
+derby.authentication.ldap.searchFilter=(&(ou=Marketing)
+ (objectClass=person))
+<ph>## all people but those in marketing
+## <ph conref="tunconrefs.dita#prod/productshortname"></ph> automatically adds (uid=<userName>)</ph>
+derby.authentication.ldap.searchFilter=(&(!(ou=Marketing)
+ (objectClass=person))
+<ph>## map %USERNAME% to user, not <i>uid</i></ph>
+derby.authentication.ldap.searchFilter=(&((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="tunconrefs.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: incubator/derby/docs/trunk/src/tuning/rtunproper37341.dita
------------------------------------------------------------------------------
svn:eol-style = native
Modified: incubator/derby/docs/trunk/src/tuning/rtunproper39325.dita
URL: http://svn.apache.org/viewcvs/incubator/derby/docs/trunk/src/tuning/rtunproper39325.dita?view=diff&r1=159547&r2=159548
==============================================================================
--- incubator/derby/docs/trunk/src/tuning/rtunproper39325.dita (original)
+++ incubator/derby/docs/trunk/src/tuning/rtunproper39325.dita Wed Mar 30 16:26:36 2005
@@ -1,54 +1,54 @@
-<?xml version="1.0" encoding="utf-8"?>
-<!--
-Copyright 1997, 2004 The Apache Software Foundation or its licensors, as applicable.
-
-Licensed under the Apache License, Version 2.0 (the "License");
-you may not use this file except in compliance with the License.
-You may obtain a copy of the License at
-
-http://www.apache.org/licenses/LICENSE-2.0
-
-Unless required by applicable law or agreed to in writing, software
-distributed under the License is distributed on an "AS IS" BASIS,
-WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
-See the License for the specific language governing permissions and
-limitations under the License.
--->
-<!DOCTYPE reference PUBLIC "-//IBM//DTD DITA Reference//EN" "../dtd/reference.dtd">
-<reference xml:lang="en-us" id="rtunproper39325">
-<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="rtunproper25025.dita#rtunproper25025"/>.</i></p>
-<p>A malformed list of user names raises an exception. Do not specify a user
-both in this property and in <i><xref href="rtunproper25025.dita#rtunproper25025"/>.</i>
-<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></p>
-</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="ctunsetprop44147.dita#ctunsetprop44147"/>.</p>
-</section></refbody></reference>
+<?xml version="1.0" encoding="utf-8"?>
+<!--
+Copyright 1997, 2004 The Apache Software Foundation or its licensors, as applicable.
+
+Licensed under the Apache License, Version 2.0 (the "License");
+you may not use this file except in compliance with the License.
+You may obtain a copy of the License at
+
+http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing, software
+distributed under the License is distributed on an "AS IS" BASIS,
+WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+See the License for the specific language governing permissions and
+limitations under the License.
+-->
+<!DOCTYPE reference PUBLIC "-//IBM//DTD DITA Reference//EN" "../dtd/reference.dtd">
+<reference xml:lang="en-us" id="rtunproper39325">
+<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="rtunproper25025.dita#rtunproper25025"/>.</i></p>
+<p>A malformed list of user names raises an exception. Do not specify a user
+both in this property and in <i><xref href="rtunproper25025.dita#rtunproper25025"/>.</i>
+<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></p>
+</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="ctunsetprop44147.dita#ctunsetprop44147"/>.</p>
+</section></refbody></reference>
Propchange: incubator/derby/docs/trunk/src/tuning/rtunproper39325.dita
------------------------------------------------------------------------------
svn:eol-style = native
Modified: incubator/derby/docs/trunk/src/tuning/rtunproper40346.dita
URL: http://svn.apache.org/viewcvs/incubator/derby/docs/trunk/src/tuning/rtunproper40346.dita?view=diff&r1=159547&r2=159548
==============================================================================
--- incubator/derby/docs/trunk/src/tuning/rtunproper40346.dita (original)
+++ incubator/derby/docs/trunk/src/tuning/rtunproper40346.dita Wed Mar 30 16:26:36 2005
@@ -1,60 +1,60 @@
-<?xml version="1.0" encoding="utf-8"?>
-<!--
-Copyright 1997, 2004 The Apache Software Foundation or its licensors, as applicable.
-
-Licensed under the Apache License, Version 2.0 (the "License");
-you may not use this file except in compliance with the License.
-You may obtain a copy of the License at
-
-http://www.apache.org/licenses/LICENSE-2.0
-
-Unless required by applicable law or agreed to in writing, software
-distributed under the License is distributed on an "AS IS" BASIS,
-WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
-See the License for the specific language governing permissions and
-limitations under the License.
--->
-<!DOCTYPE reference PUBLIC "-//IBM//DTD DITA Reference//EN" "../dtd/reference.dtd">
-<reference xml:lang="en-us" id="rtunproper40346">
-<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="tunconrefs.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 <xref href="ctunoptimz27975.dita#ctunoptimz27975"/>.</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=<b><i>numberOfLocks</i></b></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="ctunsetprop44147.dita#ctunsetprop44147"/>.</p>
-</section></refbody></reference>
+<?xml version="1.0" encoding="utf-8"?>
+<!--
+Copyright 1997, 2004 The Apache Software Foundation or its licensors, as applicable.
+
+Licensed under the Apache License, Version 2.0 (the "License");
+you may not use this file except in compliance with the License.
+You may obtain a copy of the License at
+
+http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing, software
+distributed under the License is distributed on an "AS IS" BASIS,
+WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+See the License for the specific language governing permissions and
+limitations under the License.
+-->
+<!DOCTYPE reference PUBLIC "-//IBM//DTD DITA Reference//EN" "../dtd/reference.dtd">
+<reference xml:lang="en-us" id="rtunproper40346">
+<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="tunconrefs.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 <xref href="ctunoptimz27975.dita#ctunoptimz27975"/>.</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=<b><i>numberOfLocks</i></b></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="ctunsetprop44147.dita#ctunsetprop44147"/>.</p>
+</section></refbody></reference>
Propchange: incubator/derby/docs/trunk/src/tuning/rtunproper40346.dita
------------------------------------------------------------------------------
svn:eol-style = native