<!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="list-jmsdest-1">
<refmeta><refentrytitle>list-jmsdest</refentrytitle><manvolnum>1</manvolnum>&metainfo;
</refmeta>
<refnamediv><indexterm><primary sortas="list-jmsdest ">list-jmsdest &mdash;
lists the existing JMS physical destinations</primary></indexterm><indexterm>
<primary sortas="gets all the named destinations">lists the existing JMS physical
destinations &mdash; list-jmsdest</primary></indexterm><refname>list-jmsdest
</refname><refpurpose>lists the existing JMS physical destinations</refpurpose>
</refnamediv>
<refsynopsisdiv><title>&synp-tt;</title>
<cmdsynopsis><command>list-jmsdest</command>&synopsis-common;
<arg>--desttype <replaceable>type</replaceable></arg><arg><replaceable>target
</replaceable></arg>
</cmdsynopsis></refsynopsisdiv>
<refsect1><title>&desc-tt;</title>
<para>The <command>list-jmsdest</command> command lists the JMS physical destinations.
This command is supported in remote mode only.</para>
</refsect1>
<refsect1><title>&opts-tt;</title>
<variablelist termlength="medium">&options-common;
<varlistentry><term><option role="nodash">&Dash;T</option><?Pub Caret><option
role="nodash">&Dash;&Dash;desttype</option></term><listitem><para>The type
of JMS destinations to be listed. Valid values are <filename>topic</filename>
and <filename>queue</filename>.</para>
</listitem></varlistentry>
</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 physical destinations are
to be listed. Although the <command>list-jmsdest</command> command is related
to resources, a physical destination is created and deleted using the JMS
Service, which is part of the configuration. Valid values are:<itemizedlist>
<listitem><para><literal>server</literal>, which lists the physical destinations
for the default server instance <literal>server</literal> and is the default
value</para>
</listitem>
<listitem><para><replaceable>configuration_name</replaceable>, which lists
the physical destinations for the specified configuration</para>
</listitem>
<listitem><para><replaceable>cluster_name</replaceable>, which lists the physical
destinations for the specified cluster</para>
</listitem>
<listitem><para><replaceable>instance_name</replaceable>, which lists the
physical destinations for a particular server instance</para>
</listitem>
</itemizedlist></para>
<para>&se-ee-only;</para>
</listitem></varlistentry>
</variablelist></refsect1>
<refsect1><title>&exam-tt;</title>
<example>
<title>Using the list-jmsdest command</title>
<para>The following command lists all the physical destinations for the default
server instance:</para>
<screen>asadmin> <userinput>list-jmsdest --user admin 
--passwordfile passwords.txt --host bluestar --port 4848</userinput>
PhysicalQueue queue {}
PhysicalTopic topic {}
Command list-jmsdest 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="delete-jmsdest-1"><citerefentry>
<refentrytitle>delete-jmsdest</refentrytitle><manvolnum>1</manvolnum></citerefentry></link></para>
</refsect1>
</refentry>
<?Pub *0000004150>
