<!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 EntList brvbar bull cross dash diam diams frac12 frac13 frac14 hellip
 laquo lArr loz mdash nabla ndash para pound rArr raquo sect yen ne>
<?Pub Inc>
<refentry id="ping-connection-pools-1">
<refmeta><refentrytitle>ping-connection-pools</refentrytitle><manvolnum>1
</manvolnum>&metainfo;
</refmeta>
<refnamediv><indexterm><primary sortas="ping-connection-pools">ping-connection-pools &mdash;
tests that a connection pool is usable </primary></indexterm><indexterm><primary
sortas="tests that a connection pool is usable ">tests that a connection pool
is usable  &mdash; ping-connection-pools</primary></indexterm><refname>ping-connection-pool
</refname><refpurpose>tests if a connection pool is usable </refpurpose></refnamediv>
<refsynopsisdiv><title>&synp-tt;</title>
<cmdsynopsis><command>ping-connection-pool</command>&synopsis-common;
<arg choice="plain"><replaceable>pool_name</replaceable></arg>
</cmdsynopsis></refsynopsisdiv>
<refsect1><title>&desc-tt;</title>
<para>This command tests if a connection pool is usable for both JDBC connection
pools and connector connection pools. For example, if you create a new JDBC
connection pool for an application that is expected to be deployed later,
the JDBC pool is tested with this command before deploying the application.
</para>
<para>A JDBC connection pool or a connector connection pool with authentication
can be created. You can either use a &ndash;property option to specify user,
password, or other connection information using the command line, or specify
the connection information in the xml descriptor file.</para>
<para>Before pinging a connection pool, you must create the connection pool
with authentication and ensure that the enterprise server or database is started.
</para>
</refsect1>
<refsect1><title>&opts-tt;</title>
<variablelist termlength="medium">&options-common;
<varlistentry><term><option role="nodash">&Dash;&Dash;target</option></term>
<listitem><para>This option is deprecated.</para>
</listitem></varlistentry>
</variablelist></refsect1>
<refsect1><title>&oper-tt;</title>
<variablelist termlength="medium">
<varlistentry><term><replaceable>pool_name</replaceable></term><listitem>
<para>This is the name of the pool to test.</para>
</listitem></varlistentry>
</variablelist></refsect1>
<refsect1><title>&exam-tt;</title>
<example>
<title>Using the ping-connection-pool command</title>
<screen>asadmin> <userinput>ping-connection-pool --user admin1 --passwordfile pwordfile<?Pub Caret>

</userinput>
Command ping-connection-pool executed successfully</screen>
<para>Where: asadmin is the command prompt and sampleConnectionPool is the
name of the connection pool to ping.</para>
</example>
</refsect1>
<refsect1><title>&exit-tt;</title>
<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>
</refentry>
<?Pub *0000003508>
