<!--Arbortext, Inc., 1988-2007, v.4002-->
<!DOCTYPE REFENTRY PUBLIC "-//Sun Microsystems//DTD SolBook 3.5//EN" [
<!ENTITY options-common SYSTEM "options-common.sgm">
<!ENTITY synopsis-common SYSTEM "synopsis-common.sgm">
<!ENTITY % commonents SYSTEM "common.ent">
%commonents;
]>
<?Pub UDT _bookmark _target>
<?Pub CX solbook(>
<refentry id="create-jmsdest-1"><?Pub Tag atict:info tracking="off" ref="2"><?Pub Tag
atict:user user="hl34125" fullname=""><?Pub Tag atict:user user="pmdavies"
fullname=""><?Pub Tag atict:user user="ah95648" fullname="">
<!-- @(#)create-jmsdest.1 1.10 07/07/13 SMI; -->
<refmeta><refentrytitle>create-jmsdest</refentrytitle><manvolnum>1</manvolnum>
<refmiscinfo class="date">3 Oct 2008</refmiscinfo>
<refmiscinfo class="sectdesc">&man1;</refmiscinfo>
<refmiscinfo class="software">&software;</refmiscinfo>
<refmiscinfo class="arch">generic</refmiscinfo>
<refmiscinfo class="copyright">Copyright (c) 2008, Sun Microsystems, Inc.
All Rights Reserved</refmiscinfo>
</refmeta>
<refnamediv><indexterm><primary>create-jmsdest</primary></indexterm><indexterm>
<primary>creates a JMS physical destination</primary></indexterm>
<refname>create-jmsdest</refname><refpurpose>creates a JMS physical destination</refpurpose>
</refnamediv>
<refsynopsisdiv><title></title>
<synopsis><command>create-jmsdest</command> &synopsis-common; [<option
role="double-dash">target</option> <replaceable>target</replaceable>]
 <option role="double-dash">desttype</option> <replaceable>dest_type</replaceable> [<option
role="double-dash">property</option> (<replaceable>name</replaceable>=<replaceable>
value</replaceable>)[:<replaceable>name</replaceable>=<replaceable>value</replaceable>]*]
 <replaceable>dest_name</replaceable></synopsis>
</refsynopsisdiv>
<refsect1 role="description"><title></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 role="options"><title></title>
<variablelist termlength="wholeline">&options-common;
<varlistentry><term><option role="double-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:</para>
<itemizedlist>
<listitem><para><literal>server</literal>&hyphen; Specifies the default server
instance as target for creating the physical destination. <literal>server</literal> is
the name of the default server instance. <literal>server</literal> is the
default value of this option .</para></listitem>
<listitem><para><replaceable>configuration_name</replaceable>&hyphen; Specifies
a particular configuration as the target for creating the physical destination. </para>
</listitem>
<listitem><para><replaceable>cluster_name</replaceable>&hyphen; Specifies
a certain cluster , such as cluster1, as a target for creating the physical
destination. The JMS physical destination is created on every server instance
in the cluster. </para></listitem>
<listitem><para><replaceable>instance_name</replaceable>&hyphen; Specifies
a particular server instance as a target for creating the physical destination. </para><?Pub
Caret1></listitem>
</itemizedlist>
<para>&se-ee-only;</para>
</listitem>
</varlistentry>
<varlistentry><term><option>T</option><option role="double-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="double-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>
<variablelist termlength="wholeline">
<varlistentry><term><literal>maxNumActiveConsumers</literal></term>
<listitem><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.</para>
</listitem>
</varlistentry>
</variablelist>
<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. </para>
</listitem>
</varlistentry>
</variablelist>
</refsect1>
<refsect1 role="operands"><title></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 role="examples"><title></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 role="exit-status"><title></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 role="see-also"><title></title>
<para><olink targetdoc="asrefman" targetptr="create-jms-resource-1">create-jms-resource(1)
</olink>, <olink targetdoc="asrefman" targetptr="delete-jmsdest-1">delete-jmsdest(1)
</olink>, <olink targetdoc="asrefman" targetptr="list-jmsdest-1">list-jmsdest(1)</olink></para>
</refsect1>
</refentry>
<?Pub *0000005994 0>
