db-derby-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From j..@apache.org
Subject svn commit: r357755 - in /db/derby/docs/trunk/src/tools: derbytools.ditamap rtoolsijproprefdatasource.dita rtoolsijproprefpassword.dita rtoolsijproprefuser.dita
Date Mon, 19 Dec 2005 19:06:27 GMT
Author: jta
Date: Mon Dec 19 11:06:23 2005
New Revision: 357755

URL: http://svn.apache.org/viewcvs?rev=357755&view=rev
Log:
DERBY-391 : Applied Jeff Levitt's patch that adds documentation for 
ij.datasource, ij.password, and ij.user.

Added:
    db/derby/docs/trunk/src/tools/rtoolsijproprefdatasource.dita
    db/derby/docs/trunk/src/tools/rtoolsijproprefpassword.dita
    db/derby/docs/trunk/src/tools/rtoolsijproprefuser.dita
Modified:
    db/derby/docs/trunk/src/tools/derbytools.ditamap

Modified: db/derby/docs/trunk/src/tools/derbytools.ditamap
URL: http://svn.apache.org/viewcvs/db/derby/docs/trunk/src/tools/derbytools.ditamap?rev=357755&r1=357754&r2=357755&view=diff
==============================================================================
--- db/derby/docs/trunk/src/tools/derbytools.ditamap (original)
+++ db/derby/docs/trunk/src/tools/derbytools.ditamap Mon Dec 19 11:06:23 2005
@@ -79,15 +79,19 @@
 <topicref href="rtoolsijpropref10135.dita" navtitle="ij.connection.connectionName">
 </topicref>
 <topicref href="rtoolsijpropref28146.dita" navtitle="ij.database"></topicref>
+<topicref href="rtoolsijproprefdatasource.dita" navtitle="ij.datasource">
+</topicref>
 <topicref href="rtoolsijpropref41073.dita" navtitle="ij.driver"></topicref>
 <topicref href="rtoolsijpropref28788.dita" navtitle="ij.maximumDisplayWidth">
 </topicref>
 <topicref href="rtoolsijpropref32585.dita" navtitle="ij.outfile"></topicref>
+<topicref href="rtoolsijproprefpassword.dita" navtitle="ij.password"></topicref>
 <topicref href="rtoolsijpropref35032.dita" navtitle="ij.protocol"></topicref>
 <topicref href="rtoolsijpropref12236.dita" navtitle="ij.protocol.protocolName">
 </topicref>
 <topicref href="rtoolsijpropref25589.dita" navtitle="ij.showErrorCode"></topicref>
 <topicref href="rtoolsijpropref38481.dita" navtitle="ij.URLCheck"></topicref>
+<topicref href="rtoolsijproprefuser.dita" navtitle="ij.user"></topicref>
 <topicref href="rtoolsijpropref97949.dita" navtitle="derby.ui.codeset"></topicref>
 </topicref>
 <topicref collection-type="family" href="rtoolsijcomref25570.dita" navtitle="ij commands
and errors reference">

Added: db/derby/docs/trunk/src/tools/rtoolsijproprefdatasource.dita
URL: http://svn.apache.org/viewcvs/db/derby/docs/trunk/src/tools/rtoolsijproprefdatasource.dita?rev=357755&view=auto
==============================================================================
--- db/derby/docs/trunk/src/tools/rtoolsijproprefdatasource.dita (added)
+++ db/derby/docs/trunk/src/tools/rtoolsijproprefdatasource.dita Mon Dec 19 11:06:23 2005
@@ -0,0 +1,39 @@
+<?xml version="1.0" encoding="utf-8"?>
+<!DOCTYPE reference PUBLIC "-//IBM//DTD DITA Reference//EN"
+ "../dtd/reference.dtd">
+<!-- 
+Copyright 1997, 2005 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.
+-->
+<reference id="rtoolsijproprefdatasource" xml:lang="en-us">
+<title>ij.dataSource</title>
+<prolog><metadata>
+<keywords><indexterm>ij.dataSource</indexterm></keywords>
+</metadata></prolog>
+<refbody>
+<section><title>Function</title><p>The <codeph>ij.dataSource</codeph>
property
+specifies the datasource to be used to access the database. When specifying
+a datasource, <ph conref="toolsconrefs.dita#prod/productshortname"></ph> does
+not use the DriverManager mechanism to establish connections.</p> </section>
+<refsyn><title>Syntax</title>To establish a connection using <codeph>ij.dataSource</codeph>,
+you need to set the <codeph>ij.dataSource.databaseName</codeph> and <codeph>ij.dataSource.createDatabase</codeph>
properties
+as well.<codeblock><b>ij.dataSource=<i>dataSourcename</i></b>
<b>ij.dataSource.databaseName=<i>databasename</i></b> <b>[ij.dataSource.createDatabase=create]</b
+></codeblock></refsyn>
+<example><title>Example</title><codeblock><b>java -Dij.dataSource=org.apache.derby.jdbc.EmbeddedDataSource
+-Dij.dataSource.databaseName=sample -Dij.dataSource.createDatabase=create</b></codeblock>
</example>
+<section>For more information about DataSources, refer to the JDBC documentation
+and "Using <ph conref="toolsconrefs.dita#prod/productshortname"></ph> as a
+J2EE Resource Manager" in the <cite><ph conref="toolsconrefs.dita#pub/citdevelop"></ph></cite>.</section>
+</refbody>
+</reference>

Added: db/derby/docs/trunk/src/tools/rtoolsijproprefpassword.dita
URL: http://svn.apache.org/viewcvs/db/derby/docs/trunk/src/tools/rtoolsijproprefpassword.dita?rev=357755&view=auto
==============================================================================
--- db/derby/docs/trunk/src/tools/rtoolsijproprefpassword.dita (added)
+++ db/derby/docs/trunk/src/tools/rtoolsijproprefpassword.dita Mon Dec 19 11:06:23 2005
@@ -0,0 +1,35 @@
+<?xml version="1.0" encoding="utf-8"?>
+<!DOCTYPE reference PUBLIC "-//IBM//DTD DITA Reference//EN"
+ "../dtd/reference.dtd">
+<!-- 
+Copyright 1997, 2005 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.
+-->
+<reference id="rtoolsijproprefpassword" xml:lang="en-us">
+<title>ij.password</title>
+<prolog><metadata>
+<keywords><indexterm>ij.password</indexterm></keywords>
+</metadata></prolog>
+<refbody>
+<section><title>Function</title><p>Specifies the password used to
make connections.
+When you specify the <codeph>ij.password</codeph> property, and use <codeph>ij</codeph>
to
+create the  database, you will always need to use the password in order to
+access the database unless you set up additional users.</p> </section>
+<refsyn><title>Syntax</title><codeblock><b>ij.password=<b><i>password</i></b></b></codeblock></refsyn>
+<example><title>Example</title><codeblock><b>java -Dij.user=me
-Dij.password=mine org.apache.derby.tools.ij</b></codeblock> </example>
+<section>See the <cite><ph conref="toolsconrefs.dita#pub/citdevelop"></ph></cite>
for
+more information on <ph conref="toolsconrefs.dita#prod/productshortname"></ph>
authentication
+and security.</section>
+</refbody>
+</reference>

Added: db/derby/docs/trunk/src/tools/rtoolsijproprefuser.dita
URL: http://svn.apache.org/viewcvs/db/derby/docs/trunk/src/tools/rtoolsijproprefuser.dita?rev=357755&view=auto
==============================================================================
--- db/derby/docs/trunk/src/tools/rtoolsijproprefuser.dita (added)
+++ db/derby/docs/trunk/src/tools/rtoolsijproprefuser.dita Mon Dec 19 11:06:23 2005
@@ -0,0 +1,44 @@
+<?xml version="1.0" encoding="utf-8"?>
+<!DOCTYPE reference PUBLIC "-//IBM//DTD DITA Reference//EN"
+ "../dtd/reference.dtd">
+<!-- 
+Copyright 1997, 2005 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.
+-->
+<reference id="rtoolsijproprefuser" xml:lang="en-us">
+<title>ij.user</title>
+<prolog><metadata>
+<keywords><indexterm>ij.user</indexterm></keywords>
+</metadata></prolog>
+<refbody>
+<section><title>Function</title><p>Specifies the user with which
connections
+are made by default. When you connect using <codeph>ij.user</codeph>, <codeph>ij</codeph>
assumes
+that the database schema to be used is the same as the user id provided. However,
+certain database objects cannot be created until a schema exists (such as
+after a CREATE SCHEMA statement has been issued, followed by a SET SCHEMA
+statement, or by fully qualifying the database objects to be created). If
+no user is specified, no SET SCHEMA statement has been issued, or CREATE statements
+do not qualify the schema, all database objects are assumed to be under the
+APP schema.</p> </section>
+<refsyn><title>Syntax</title><codeblock><b>ij.user=<b><i>username</i></b></b></codeblock></refsyn>
+<example><title>Example</title><codeblock><b>java -Dij.user=me
-Dij.password=mine org.apache.derby.tools.ij</b>
+ij version 10.2
+ij> <b>connect 'jdbc:derby:sampleDB';</b>
+ij> <b>set schema finance;</b>
+ij> <b>select * from accounts;</b></codeblock> </example>
+<section>See the <cite><ph conref="toolsconrefs.dita#pub/citdevelop"></ph></cite>
for
+more information on <ph conref="toolsconrefs.dita#prod/productshortname"></ph>
and
+security.</section>
+</refbody>
+</reference>



Mime
View raw message