<!--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-admin-object-1">
<!-- @(#)create-admin-object.1 1.14 07/07/25 SMI; -->
<refmeta><refentrytitle>create-admin-object</refentrytitle><manvolnum>1</manvolnum>
<refmiscinfo class="date">24 July 2007</refmiscinfo>
<refmiscinfo class="sectdesc">&man1;</refmiscinfo>
<refmiscinfo class="software">&software;</refmiscinfo>
<refmiscinfo class="arch">generic</refmiscinfo>
<refmiscinfo class="copyright">Copyright (c) 2007, Sun Microsystems, Inc.
All Rights Reserved</refmiscinfo>
</refmeta>
<refnamediv><indexterm><primary>create-admin-object</primary></indexterm>
<indexterm><primary>adds the administered object with the specified JNDI name</primary>
</indexterm>
<refname>create-admin-object</refname><refpurpose>adds the administered object
with the specified JNDI name</refpurpose></refnamediv>
<refsynopsisdiv><title></title>
<synopsis><command>create-admin-object  </command> <option role="double-dash">restype
</option> <replaceable>aorestype</replaceable>
 <option role="double-dash">raname</option> <replaceable> resource_adapter_name </replaceable>&synopsis-common;
[<option role="double-dash">enabled</option>={<replaceable>true | false</replaceable>}] [<option
role="double-dash">target</option> <replaceable>target</replaceable>] [<option
role="double-dash">description</option> <replaceable>text</replaceable>]
 [<option role="double-dash">property</option> <replaceable>name=value[:name=value]
</replaceable>*]
 <replaceable>jndi_name</replaceable></synopsis>
</refsynopsisdiv>
<refsect1 role="description"><title></title>
<para>This command creates the administered object that has a specified JNDI
name.</para>
</refsect1>
<refsect1 role="options"><title></title>
<variablelist termlength="medium">&options-common;
<varlistentry><term><option role="double-dash">target</option></term>
<listitem><para>Specifies the target on which you are creating the administered
object. Valid values are</para>
<itemizedlist>
<listitem><para><literal>server</literal>&hyphen; Specifies the default server
instance as the target for creating the administered object. The name of the
default server instance is <literal>server</literal> and is the default value
for this option. </para></listitem>
<listitem><para><replaceable>configuration_name</replaceable>&hyphen; Specifies
a particular configuration as the target for creating the administered object. </para>
</listitem>
<listitem><para><replaceable>cluster_name</replaceable>&hyphen; Specifies
a particular cluster as the target for creating the administered object.</para>
</listitem>
<listitem><para><replaceable>instance_name</replaceable>&hyphen; Specifies
a particular server instance as the target for creating the administered object.</para>
</listitem>
</itemizedlist>
</listitem><?Pub Caret>
</varlistentry>
<varlistentry><term><option role="double-dash">enabled </option></term>
<listitem><para>Specifies if this object is enabled. The default value is
true.</para>
</listitem>
</varlistentry>
<varlistentry><term><option role="double-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="double-dash">raname</option></term>
<listitem><para>This is the name of the resource adapter associated with this
object.</para>
</listitem>
</varlistentry>
<varlistentry><term><option></option><option>description</option></term>
<listitem><para>This option is the text description of the administered object.</para>
</listitem>
</varlistentry>
<varlistentry><term><option role="double-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 role="operands"><title></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 role="examples"><title></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 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="delete-admin-object-1">delete-admin-object(1)
</olink>, <olink targetdoc="asrefman" targetptr="list-admin-objects-1">list-admin-objects(1)
</olink></para>
</refsect1>
</refentry>
<?Pub *0000005404 0>
