<!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="jms-ping-1">
<refmeta><refentrytitle>jms-ping</refentrytitle><manvolnum>1</manvolnum>&metainfo;
</refmeta>
<refnamediv><indexterm><primary sortas="jms&mdash;ping ">jms-ping  &mdash;
checks to see if the JMS service is up and running</primary></indexterm><indexterm>
<primary sortas="checks to see if the JMS provider is up and running.">checks
to see if the JMS service is up and running &mdash; jms-ping </primary></indexterm>
<refname>jms-ping </refname><refpurpose>checks if the JMS service is up and
running</refpurpose></refnamediv>
<refsynopsisdiv><title>&synp-tt;</title>
<cmdsynopsis><command>jms-ping</command>&synopsis-common;
<arg><replaceable>target</replaceable></arg>
</cmdsynopsis></refsynopsisdiv>
<refsect1><title>&desc-tt;</title>
<para>The <command>jms-ping</command> command checks if the JMS service (also
known as the JMS provider) is up and running. When you start the Application
Server, the JMS service starts by default. </para>
<para>The <command>jms-ping</command> command pings only the default JMS host
within the JMS service. It displays an error message when it is unable to
ping a built-in JMS service.</para>
<para>This command is supported in remote mode only.</para>
</refsect1>
<refsect1><title>&opts-tt;</title>
<variablelist termlength="medium">&options-common;
</variablelist></refsect1>
<refsect1><title>&oper-tt;</title>
<variablelist termlength="medium">
<varlistentry><term><replaceable>target</replaceable></term><listitem><para>
This operand specifies the target for which the operation is to be performed.
Valid values are:<itemizedlist>
<listitem><para><literal>server</literal>, which pings the JMS service for
the default server instance. This is the default value</para>
</listitem>
<listitem><para><replaceable>configuration_name</replaceable>, which pings
the JMS service for all clusters using the specified configuration</para>
</listitem>
<listitem><para><replaceable>cluster_name</replaceable>, which pings the JMS
service for the specified cluster</para>
</listitem>
<listitem><para><replaceable>instance_name</replaceable>, which pings the
JMS service for a particular server instance</para>
</listitem>
</itemizedlist></para>
<para>&oper-se-ee-only;<?Pub Caret></para>
</listitem></varlistentry>
</variablelist></refsect1>
<refsect1><title>&exam-tt;</title>
<example>
<title>Using the jms-ping command</title>
<para>The following command checks to see if the JMS service is running on
the server instance <literal>server1</literal>:</para>
<screen>asadmin> <userinput>jms-ping --user admin 
--passwordfile passwords.txt --host bluestar --port 4848 
server1</userinput>
JMS Ping Status=RUNNING
Command jms-ping executed successfully.</screen>
</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>
<refsect1><title>&also-tt;</title>
<para><link linkend="create-jmsdest-1"><citerefentry><refentrytitle>create-jmsdest
</refentrytitle><manvolnum>1</manvolnum></citerefentry></link>, <link linkend="create-jms-resource-1"><citerefentry>
<refentrytitle>create-jms-resource</refentrytitle><manvolnum>1</manvolnum>
</citerefentry></link></para>
</refsect1>
</refentry>
<?Pub *0000004060>
