<!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 ERROR-CODES "ERROR CODES">
<!ENTITY Date "22 Dec 2004">
<!ENTITY SectDesc "User Commands">
<!ENTITY Software "J2EE SDK 1.4">
<!ENTITY arch "generic">
<!ENTITY copyright "Copyright (c) 2004, Sun Microsystems, Inc. All Rights Reserved">
<!ENTITY exam-tt "EXAMPLES">
<!ENTITY options-common SYSTEM "options-common.sgm">
<!ENTITY synopsis-common SYSTEM "synopsis-common.sgm">
<!ENTITY sjsas "Sun Java System Application Server">
<!ENTITY attr-tt "ATTRIBUTES">
<!ENTITY opts-tt "OPTIONS">
<!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="create-admin-object-1">
<refmeta><refentrytitle>create-admin-object</refentrytitle><manvolnum>1</manvolnum>&metainfo;
</refmeta>
<refnamediv><indexterm><primary sortas="create-admin-object">create-admin-object &mdash;
adds the administered object with the specified JNDI name</primary></indexterm>
<indexterm><primary sortas="adds the administered object with the specified JNDI name">
adds the administered object with the specified JNDI name &mdash; create-admin-object
</primary></indexterm><refname>create-admin-object</refname><refpurpose>adds
the administered object with the specified JNDI name</refpurpose></refnamediv>
<refsynopsisdiv><title>&synp-tt;</title>
<cmdsynopsis><command><command>create-admin-object</command> </command><arg
choice="plain">&Dash;&Dash;restype <replaceable>aorestype</replaceable></arg>
<arg choice="plain">&Dash;&Dash;raname <replaceable> resource_adapter_name 
</replaceable></arg>&synopsis-common;
<?Pub Caret1><arg choice="opt">&Dash;&Dash;target <replaceable>target</replaceable></arg>
<arg choice="opt">&Dash;&Dash;description <replaceable>text</replaceable></arg>
<arg choice="opt">&Dash;&Dash;property <replaceable>name=value[:name=value]
</replaceable>*</arg><arg choice="plain"><replaceable>jndi_name</replaceable></arg>
</cmdsynopsis></refsynopsisdiv>
<refsect1><title>&desc-tt;</title>
<para>This command creates the administered object that has a specified JNDI
name.</para>
</refsect1>
<refsect1><title>OPTIONS</title>
<variablelist termlength="medium">&options-common;
<varlistentry><term><option role="nodash">&Dash;&Dash;target</option></term>
<listitem><para>Specifies the target on which you are creating the administered
object. Valid values are<itemizedlist>
<listitem><para><literal>server</literal>, which creates the administered
object for the default server instance <literal>server</literal> and is the
default value</para>
</listitem>
<listitem><para><replaceable>configuration_name</replaceable>, which creates
the administered object for the named configuration</para>
</listitem>
<listitem><para><replaceable>cluster_name</replaceable>, which creates the
administered object for every server instance in the cluster</para>
</listitem>
<listitem><para><replaceable>instance_name</replaceable>, which creates the
administered object for a particular server instance</para>
</listitem>
</itemizedlist></para>
</listitem></varlistentry>
<varlistentry><term><option role="nodash">&Dash;&Dash;restype </option></term>
<listitem><para>This option is used to administer the object resource types,
as defined by the resource adapter in the ra.xml file.</para>
</listitem></varlistentry>
<varlistentry><term> <option role="nodash">&Dash;&Dash;raname</option></term>
<listitem><para>This is the name of the resource adapter associated with this
object.</para>
</listitem></varlistentry>
<varlistentry><term><option role="nodash">&Dash;</option><option role="nodash">&Dash;description
</option></term><listitem><para>This option is the text description of the
administered object.</para>
</listitem></varlistentry>
<varlistentry><term><option role="nodash">&Dash;&Dash;property</option></term>
<listitem><para>This option describes the &ldquo;name/values&rdquo; pairs
for configuring the resource.</para>
</listitem></varlistentry>
</variablelist></refsect1>
<refsect1><title>OPERANDS</title>
<variablelist termlength="medium">
<varlistentry><term><replaceable>jndi_name</replaceable></term><listitem>
<para>This is the JNDI name of the administered object to be created.</para>
</listitem></varlistentry>
</variablelist></refsect1>
<refsect1><title>&exam-tt;</title>
<example>
<title>Using create-admin-object</title>
<para>The<classname> javax.jms.Queue</classname> resource type is obtained
from the <filename>ra.xml</filename> file. The <classname>jmsrar.rar</classname>
must be deployed prior to executing this command.</para>
<screen>asadmin> <userinput>create-admin-object --user admin1 --passwordfile  passwords.txt
--restype javax.jms.Queue --raname jmsra --description "sample administered object" 
--property Name=sample_jmsqueue jms/samplequeue</userinput>
Command create-admin-object 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="delete-admin-object-1"><citerefentry><refentrytitle>
delete-admin-object</refentrytitle><manvolnum>1</manvolnum></citerefentry></link>, <link
linkend="list-admin-objects-1"><citerefentry><refentrytitle>list-admin-objects
</refentrytitle><manvolnum>1</manvolnum></citerefentry></link></para>
</refsect1>
</refentry>
<?Pub *0000005935>
