<!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 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-jndi-resource-1">
<refmeta><refentrytitle>create-jndi-resource</refentrytitle><manvolnum>1</manvolnum>&metainfo;
</refmeta>
<refnamediv><indexterm><primary sortas="template">create-jndi-resource &mdash;
registers a JNDI resource</primary></indexterm><indexterm><primary sortas="template for documenting manpages for the Sun Java System Application Server">
registers a JNDI resource&mdash; create-jndi-resource</primary></indexterm>
<refname>create-jndi-resource</refname><refpurpose>registers a JNDI resource
</refpurpose></refnamediv>
<refsynopsisdiv><title>&synp-tt;</title>
<cmdsynopsis><command>create-jndi-resource</command>&synopsis-common;
<arg>&Dash;&Dash;target<replaceable>target</replaceable></arg><arg choice="plain">&Dash;&Dash;jndilookupname <replaceable>
lookup_name</replaceable></arg><arg choice="plain">&Dash;&Dash;restype <replaceable>
type </replaceable></arg><arg choice="plain">&Dash;&Dash;factoryclass <replaceable>
class_name</replaceable></arg><arg>&Dash;&Dash;enabled=true</arg><arg>&Dash;&Dash;description <replaceable>
text</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>jndi_name
</replaceable></arg>
</cmdsynopsis></refsynopsisdiv>
<refsect1><title>&desc-tt;</title>
<para>The <command>create-jndi-resource</command> command registers a JNDI
resource. 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 to which you are deploying. &se-ee-only;</para>
<para>Valid values for target are described below. <itemizedlist>
<listitem><para><literal>server</literal>, which creates the resource for
the default server instance. This is the default value</para>
</listitem>
<listitem><para><literal>domain</literal>, which creates the resource for
the domain</para>
</listitem>
<listitem><para><replaceable>cluster_name</replaceable>, which creates the
resource for every server instance in the cluster</para>
</listitem>
<listitem><para><replaceable>instance_name</replaceable>, which creates the
resource for a particular server instance</para>
</listitem>
</itemizedlist></para>
</listitem></varlistentry>
<varlistentry><term><option role="nodash">&Dash;&Dash;jndilookupname</option></term>
<listitem><para>The lookup name that the external container uses.</para>
</listitem></varlistentry>
<varlistentry><term><option role="nodash">&Dash;&Dash;resourcetype</option></term>
<listitem><para>This option is deprecated. Use <option role="nodash">--restype
</option> instead.</para>
</listitem></varlistentry>
<varlistentry><term><option role="nodash">&Dash;&Dash;restype</option></term>
<listitem><para>The JNDI resource type. It can be topic or queue.</para>
</listitem></varlistentry>
<varlistentry><term><option role="nodash">&Dash;&Dash;factoryclass</option></term>
<listitem><para>The class that creates the JNDI resource.</para>
</listitem></varlistentry>
<varlistentry><term><option role="nodash">&Dash;&Dash;enabled</option></term>
<listitem><para>Determines whether the resource is enabled at runtime.</para>
</listitem></varlistentry>
<varlistentry><term><option role="nodash">&Dash;&Dash;description</option></term>
<listitem><para>The text that provides details about the JNDI resource.</para>
</listitem></varlistentry>
<varlistentry><term><option role="nodash">&Dash;&Dash;property</option></term>
<listitem><para>Optional attribute name/value pairs for configuring the resource.
The following properties are available:</para>
<para><informaltable frame="all" orient="port">
<tgroup cols="2">
<?PubTbl tgroup dispwid="7.57in">
<colspec colname="col1" colwidth="0.82*"><colspec colname="col2" colwidth="1.18*">
<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" align="center"><para>http-listener-1&ndash;port
</para></entry><entry colname="col2" align="center"><para>This property specifies
the port number for http-listener-1. Valid values are 1&ndash;65535. On UNIX,
creating sockets that listen on ports 1&ndash;1024 requires superuser privileges.
</para></entry></row>
<row><entry colname="col1" align="center"><para>http-listener-2&ndash;port
</para></entry><entry colname="col2" align="center"><para>This property specifies
the port number for http-listener-2. Valid values are 1&ndash;65535. On UNIX,
creating sockets that listen on ports 1&ndash;1024 requires superuser privileges.
</para></entry></row>
<row><entry colname="col1"><para>orb-listener-1&ndash;port</para></entry>
<entry colname="col2"><para>This property specifies which ORB listener port
for IIOP connections orb-listener-1 listens on. </para></entry></row>
<row><entry colname="col1"><para>IIOP_SSL_LISTENER_PORT</para></entry><entry
colname="col2"><para>This property specifies which ORB listener port for IIOP
connections the IIOP listener called SSL listens on.</para></entry></row>
<row><entry colname="col1"><para>IIOP_SSL_MUTUALAUTH_PORT</para></entry><entry
colname="col2"><para>This property specifies which ORB listener port for IIOP
connections the IIOP listener called SSL_MUTUALAUTH listens on.</para></entry>
</row>
<row><entry colname="col1"><para>JMX_SYSTEM_Connector-port</para></entry>
<entry colname="col2"><para>This property specifies the port number on which
the JMX connector listens. Valid values are 1&ndash;65535. On UNIX, creating
sockets that listen on ports 1&ndash;1024 requires superuser privileges.</para></entry>
</row>
</tbody>
</tgroup>
</informaltable></para>
</listitem></varlistentry>
</variablelist></refsect1>
<refsect1><title>&oper-tt;</title>
<variablelist termlength="medium">
<varlistentry><term><replaceable>jndi_name</replaceable></term><listitem>
<para>The name of the JNDI resource to be created. This name must be unique.
</para>
</listitem></varlistentry>
</variablelist></refsect1>
<refsect1><title>&exam-tt;</title>
<example>
<title>Using the create-jndi-resource command</title>
<screen>asadmin> <userinput>create-jndi-resource --user admin --passwordfile passwords.txt<?Pub Caret> 
--host pigeon --port 4001 --jndilookupname sample_jndi --restype queue 
--factoryclass sampleClass --description "this is a sample jndi 
resource" sample_jndi_resource</userinput>
Command create-jndi-resource executed successfully</screen>
<para>Where <command>sample_jndi_resource</command> is the new JNDI resource
created.</para>
</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="delete-jndi-resource-1"><citerefentry><refentrytitle>
delete-jndi-resource</refentrytitle><manvolnum>1</manvolnum></citerefentry></link>,<link
linkend="list-jndi-resources-1"><citerefentry><refentrytitle>list-jndi-resources
</refentrytitle><manvolnum>1</manvolnum></citerefentry></link></para>
</refsect1>
</refentry>
<?Pub *0000008132>
