<!DOCTYPE REFENTRY PUBLIC "-//Sun Microsystems//DTD DocBook V3.0-Based SolBook Subset V2.0//EN" [
<!--ArborText, Inc., 1988-1999, v.4002-->
<!ENTITY metainfo SYSTEM "metainfo.sgm">
<!ENTITY options-common SYSTEM "options-common.sgm">
<!ENTITY synopsis-common SYSTEM "synopsis-common.sgm">
<!ENTITY % commonents SYSTEM "smancommon.ent">
%commonents;
<!ENTITY % booktitles SYSTEM "booktitles.ent">
%booktitles;
<!ENTITY Dash "&ndash;">
]>
<?Pub UDT _bookmark _target>
<?Pub Inc>
<refentry id="stop-database-1">
<refmeta><refentrytitle>stop-database</refentrytitle><manvolnum>1</manvolnum>&metainfo;
</refmeta>
<refnamediv><indexterm><primary sortas="stop-database">stop&ndash;database &mdash;
stops the bundled Java DB</primary></indexterm><indexterm><primary sortas="stops the bundled Derby database">
stops the bundled Java DB&mdash; stop-database</primary></indexterm><refname>
stop-database</refname><refpurpose>stops Java DB</refpurpose></refnamediv>
<refsynopsisdiv><title>&synp-tt;</title>
<cmdsynopsis><command>stop-database</command><arg>&Dash;&Dash;dbhost <replaceable>
0.0.0.0</replaceable></arg><arg>&Dash;&Dash;dbport <replaceable>1527</replaceable></arg>
</cmdsynopsis></refsynopsisdiv>
<refsect1><title>&desc-tt;</title>
<para>The <command>stop-database</command> command stops a process of the
Java DB server. Java DB server is available with the Sun Java System Application
Server software for use with the Application Server. Java DB is based upon
Apache Derby. The database is typically started with the <command>asadmin
start-database</command> command. Note that a single host can have multiple
database server processes running on different ports. This command stops the
database server process for the specified port only. </para>
<para>This command is supported in local mode only.</para>
</refsect1>
<refsect1><title>&opts-tt;</title>
<variablelist termlength="medium">
<varlistentry><term><option role="nodash">&Dash;&Dash;dbhost</option></term>
<listitem><para>The host name or IP address of the Java DB server process.
The default is the IP address 0.0.0.0, which denotes all network interfaces
on the host where you run the <command>stop-database</command> command.</para>
</listitem></varlistentry>
<varlistentry><term><option role="nodash">&Dash;&Dash;dbport</option></term>
<listitem><para>The port number where the Java DB server listens for client
connections. The default is 1527.</para>
</listitem></varlistentry>
</variablelist></refsect1>
<refsect1><title>&exam-tt;</title>
<example>
<title>Using the stop-database command</title>
<para>The following command stops Java DB on the host host1 and port 5001:
</para>
<screen>asadmin> <userinput>stop-database --dbhost host1 --dbport 5001</userinput>
Connection obtained for host: host1, port number 5001.
Shutdown successful.
Command stop-database executed successfully.</screen>
</example>
</refsect1>
<refsect1><title>&exit-tt;</title>
<para>The exit status applies to errors in executing the <command>asadmin
</command> command. For information on database errors, see the <filename>
derby.log</filename> file. This file is located in the directory you specified
using the <literal>dbhome</literal> option when you ran <literal>start-database
</literal>, or if you did not specify <literal>dbhome</literal>, the value
of DERBY_INSTALL, which defaults to <replaceable>install-dir</replaceable><literal>
/javadb<?Pub Caret></literal>.</para>
<variablelist termlength="medium">
<varlistentry><term>0</term><listitem><para>command executed successfully
</para>
</listitem></varlistentry>
<varlistentry><term>1</term><listitem><para>error in executing the command
</para>
</listitem></varlistentry>
</variablelist></refsect1>
<refsect1><title>&also-tt;</title>
<para><link linkend="start-database-1"><citerefentry><refentrytitle>start-database
</refentrytitle><manvolnum>1</manvolnum></citerefentry></link></para>
</refsect1>
</refentry>
<?Pub *0000003938>
