<!DOCTYPE REFENTRY PUBLIC "-//Sun Microsystems//DTD DocBook V3.0-Based SolBook Subset V2.0//EN" [
<!--ArborText, Inc., 1988-1999, v.4002-->
<!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;">
<!ENTITY metainfo SYSTEM "metainfo.sgm">
]>
<?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="create-jmsdest-1">
<refmeta><refentrytitle>create-jmsdest</refentrytitle><manvolnum>1</manvolnum>&metainfo;
</refmeta>
<refnamediv><indexterm><primary sortas="create-jmsdest ">create-jmsdest &mdash;
creates a JMS physical destination</primary></indexterm><indexterm><primary
sortas="adds the named destination">creates a JMS <?Pub Caret>physical destination &mdash;
create-jmsdest</primary></indexterm><refname>create-jmsdest</refname><refpurpose>
creates a JMS physical destination</refpurpose></refnamediv>
<refsynopsisdiv><title>&synp-tt;</title>
<cmdsynopsis><command>create-jmsdest</command>&synopsis-common;
<arg>&Dash;&Dash;target <replaceable>target</replaceable></arg><arg choice="plain">&Dash;&Dash;desttype <replaceable>
dest_type</replaceable></arg><arg><option role="nodash">&Dash;&Dash;property (<replaceable>
name</replaceable>=<replaceable>value</replaceable>)[:<replaceable>name</replaceable>=<replaceable>
value</replaceable>]*</option></arg><arg choice="plain"><replaceable>dest_name
</replaceable></arg>
</cmdsynopsis></refsynopsisdiv>
<refsect1><title>&desc-tt;</title>
<para>The <command>create-jmsdest</command> command creates a JMS physical
destination. Along with the physical destination, you use the <command>create-jms-resource
</command> command to create a JMS destination resource that has a <literal>
Name</literal> property that specifies the physical destination. 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;&Dash;target</option></term>
<listitem><para>This option helps specify the target for which you are creating
the physical destination. Although the <command>create-jmsdest</command> command
is related to resources, a physical destination is created using the JMS Service
(JMS Broker), which is part of the configuration. A JMS Broker is configured
in the config section of <filename>domain.xml</filename>. Valid values are:<itemizedlist>
<listitem><para><literal>server</literal>, which creates the physical destination
for the default server instance. This is the default value.</para>
</listitem>
<listitem><para><replaceable>configuration_name</replaceable>, which creates
the physical destination for the named configuration</para>
</listitem>
<listitem><para><replaceable>cluster_name</replaceable>, which creates the
physical destination for every server instance in the cluster</para>
</listitem>
<listitem><para><replaceable>instance_name</replaceable>, which creates the
physical destination for a particular server instance</para>
</listitem>
</itemizedlist></para>
<para>&se-ee-only;</para>
</listitem></varlistentry>
<varlistentry><term><option role="nodash">&Dash;T</option><option role="nodash">&Dash;&Dash;desttype
</option></term><listitem><para>The type of the JMS destination. Valid values
are <filename>topic</filename> and <filename>queue</filename>.</para>
</listitem></varlistentry>
<varlistentry><term><option role="nodash">&Dash;&Dash;property</option></term>
<listitem><para>Optional attribute name/value pairs for configuring the physical
destination. You can specify the following property for a physical destination:
</para>
<informaltable frame="all" orient="port">
<tgroup cols="2">
<?PubTbl tgroup dispwid="9.17in">
<colspec colname="col1" colwidth="0.68*"><colspec colname="col2" colwidth="1.32*">
<thead>
<row><entry align="center" valign="top"><para>Property</para></entry><entry
align="center" valign="top"><para>Definition</para></entry></row>
</thead>
<tbody>
<row><entry colname="col1"><para>maxNumActiveConsumers</para></entry><entry
colname="col2"><para>The maximum number of consumers that can be active in
load-balanced delivery from a queue destination. A value of -1 means an unlimited
number. The default is 1. (Platform Edition limits this value to 2.)</para></entry>
</row>
</tbody>
</tgroup>
</informaltable>
<para>To modify the value of this property or to specify other physical destination
properties, use the<replaceable>install_dir</replaceable><literal>/imq/bin/imqcmd
</literal> command. See the <citetitle>Sun Java System Message Queue 3 2005Q1
Administration Guide</citetitle> for more information.</para>
</listitem></varlistentry>
</variablelist></refsect1>
<refsect1><title>&oper-tt;</title>
<variablelist termlength="medium">
<varlistentry><term><replaceable>dest_name</replaceable></term><listitem>
<para>A unique identifier for the JMS destination to be created.</para>
</listitem></varlistentry>
</variablelist></refsect1>
<refsect1><title>&exam-tt;</title>
<example>
<title>Using the create-jmsdest command</title>
<para>The following command creates a JMS physical queue named <literal>PhysicalQueue
</literal>.</para>
<screen>asadmin> <userinput>create-jmsdest --user admin 
--passwordfile passwords.txt --host localhost --port 4848 --desttype queue 
--property User=public:Password=public PhysicalQueue</userinput>
Command create-jmsdest executed successfully.</screen>
</example>
</refsect1>
<refsect1><title>EXIT STATUS</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-jms-resource-1"><citerefentry><refentrytitle>
create-jms-resource</refentrytitle><manvolnum>1</manvolnum></citerefentry></link>, <link
linkend="delete-jmsdest-1"><citerefentry><refentrytitle>delete-jmsdest</refentrytitle>
<manvolnum>1</manvolnum></citerefentry></link>, <link linkend="list-jmsdest-1"><citerefentry>
<refentrytitle>list-jmsdest</refentrytitle><manvolnum>1</manvolnum></citerefentry></link></para>
</refsect1>
</refentry>
<?Pub *0000006533>
