<!--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-jndi-resource-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-jndi-resource.1 1.11 07/07/27 SMI; -->
<refmeta><refentrytitle>create-jndi-resource</refentrytitle><manvolnum>1</manvolnum>
<refmiscinfo class="date">30 Jan 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-jndi-resource</primary></indexterm>
<indexterm><primary>registers a JNDI resource</primary></indexterm>
<refname>create-jndi-resource</refname><refpurpose>registers a JNDI resource</refpurpose>
</refnamediv>
<refsynopsisdiv><title></title>
<synopsis><command>create-jndi-resource</command> &synopsis-common; [<option
role="double-dash">target</option><replaceable>target</replaceable>]
 <option role="double-dash">jndilookupname</option> <replaceable>lookup_name</replaceable> <option
role="double-dash">restype</option> <replaceable>type </replaceable>
 <option role="double-dash">factoryclass</option> <replaceable>class_name</replaceable> [<option
role="double-dash">enabled</option>=true]
 [<option role="double-dash">description</option> <replaceable>text</replaceable>] [<option
role="double-dash">property</option> (<replaceable>name</replaceable>=<replaceable>
value</replaceable>)[:<replaceable>name</replaceable>=<replaceable>value</replaceable>]*]
 <replaceable>jndi_name</replaceable></synopsis>
</refsynopsisdiv>
<refsect1 role="description"><title></title>
<para>The <command>create-jndi-resource</command> command registers a JNDI
resource. This command is supported in remote mode only.</para>
</refsect1>
<refsect1 role="options"><title></title>
<variablelist termlength="medium">&options-common;
<varlistentry><term><option role="double-dash">target</option></term>
<listitem><para>This option helps specify the target on which the JNDI resource
is registered . </para>
<para>Valid values for target are described below. </para>
<itemizedlist>
<listitem><para><literal>server</literal>&hyphen; Specifies the default server
instance as the target for registering the JNDI resource.  <literal>server</literal> is
the name of the default server instance and is the default value.</para>
</listitem>
<listitem><para><literal>domain</literal>&hyphen; Specifies a certain domain
as the target for registering the JNDI resource. </para></listitem>
<listitem><para><replaceable>cluster_name</replaceable>&hyphen; Specifies
a certain cluster as the target for registering the JNDI resource. </para>
</listitem>
<listitem><para><replaceable>instance_name</replaceable>&hyphen; Specifies
a certain instance as the target<?Pub Caret> for registering the JNDI resource.</para>
</listitem>
</itemizedlist>
</listitem>
</varlistentry>
<varlistentry><term><option role="double-dash">jndilookupname</option></term>
<listitem><para>The lookup name that the external container uses.</para>
</listitem>
</varlistentry>
<varlistentry><term><option role="double-dash">resourcetype</option></term>
<listitem><para>This option is deprecated. Use <option>--restype</option> instead.
</para>
</listitem>
</varlistentry>
<varlistentry><term><option role="double-dash">restype</option></term>
<listitem><para>The JNDI resource type. It can be topic or queue.</para>
</listitem>
</varlistentry>
<varlistentry><term><option role="double-dash">factoryclass</option></term>
<listitem><para>The class that creates the JNDI resource.</para>
</listitem>
</varlistentry>
<varlistentry><term><option role="double-dash">enabled</option></term>
<listitem><para>Determines whether the resource is enabled at runtime.</para>
</listitem>
</varlistentry>
<varlistentry><term><option role="double-dash">description</option></term>
<listitem><para>The text that provides details about the JNDI resource.</para>
</listitem>
</varlistentry>
<varlistentry><term><option role="double-dash">property</option></term>
<listitem><para>Optional attribute name/value pairs for configuring the resource.
The following properties are available:</para>
<variablelist>
<varlistentry><term>http-listener-1<option>port</option></term>
<listitem><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>
</listitem>
</varlistentry>
<varlistentry><term>http-listener-2<option>port</option></term>
<listitem><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>
</listitem>
</varlistentry>
<varlistentry><term>orb-listener-1<option>port</option></term>
<listitem><para>This property specifies the ORB listener port for IIOP connections
that orb-listener-1 listens on. </para>
</listitem>
</varlistentry>
<varlistentry><term>IIOP_SSL_LISTENER_PORT</term>
<listitem><para>This property specifies the ORB listener port for IIOP connections
that the IIOP listener called SSL listens on.</para>
</listitem>
</varlistentry>
<varlistentry><term>IIOP_SSL_MUTUALAUTH_PORT</term>
<listitem><para>This property specifies the ORB listener port for IIOP connections
that the IIOP listener called SSL_MUTUALAUTH listens on.</para>
</listitem>
</varlistentry>
<varlistentry><term>JMX_SYSTEM_Connector-port</term>
<listitem><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>
</listitem>
</varlistentry>
</variablelist>
</listitem>
</varlistentry>
</variablelist>
</refsect1>
<refsect1 role="operands"><title></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 role="examples"><title></title>
<example><title>Using the create-jndi-resource command</title>
<screen>asadmin> <userinput>create-jndi-resource --user admin --passwordfile passwords.txt 
--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 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-jndi-resource-1">delete-jndi-resource(1)
</olink>,<olink targetdoc="asrefman" targetptr="list-jndi-resources-1">list-jndi-resources(1)
</olink></para>
</refsect1>
</refentry>
<?Pub *0000007499 0>
