<!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 sjsas "Sun Java System Application Server">
<!ENTITY opts-tt "OPTIONS">
<!ENTITY % commonents SYSTEM "smancommon.ent">
%commonents;
<!ENTITY % booktitles SYSTEM "booktitles.ent">
%booktitles;
<!ENTITY Dash "&ndash;">
]>
<?Pub UDT _bookmark _target>
<?Pub Inc>
<refentry id="create-connector-resource-1">
<refmeta><refentrytitle>create-connector-resource</refentrytitle><manvolnum>
1</manvolnum>&metainfo;
</refmeta>
<refnamediv><indexterm><primary sortas="template">create-connector-resource &mdash;registers
the connector resource with the specified JNDI name</primary></indexterm>
<indexterm><primary sortas="template for documenting manpages for the Sun Java System Application Server">
registers the connector resource with the specified JNDI name &mdash; create-connector&mdash;resource
</primary></indexterm><refname>create-connector-resource</refname><refpurpose>
registers the connector resource with the specified JNDI name</refpurpose>
</refnamediv>
<refsynopsisdiv><title>&synp-tt;</title>
<cmdsynopsis><command>create-connector-resource</command>&synopsis-common;
<arg><option role="nodash">--target <replaceable>target</replaceable></option></arg>
<arg choice="plain">--poolname <replaceable>connectorConnectionPoolName</replaceable></arg>
<arg><option role="nodash">&Dash;&Dash;enabled=<replaceable>true</replaceable></option></arg>
<arg><option role="nodash">-<?Pub Caret1>-description <replaceable>text</replaceable></option></arg>
<arg choice="plain"><replaceable>jndi_name</replaceable></arg>
</cmdsynopsis></refsynopsisdiv>
<refsect1><title>&desc-tt;</title>
<para>This command registers the connector resource with the JNDI name, which
is specified by the <replaceable>jndi_name</replaceable> operand. </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 specifies the ending location of the connector
resources. Valid targets are:<itemizedlist>
<listitem><para><literal>server</literal>, which creates the connector resource
in the default server instance. This is the default value.</para>
</listitem>
<listitem><para><literal>domain</literal>, which creates the connector resource
in the domain.</para>
</listitem>
<listitem><para><replaceable>cluster_name</replaceable>, which creates the
connector resource in every server instance in the cluster.</para>
</listitem>
<listitem><para><replaceable>instance_name</replaceable>, which creates the
connector resource in the specified server instance.</para>
</listitem>
</itemizedlist></para>
<para>&se-ee-only;</para>
</listitem></varlistentry>
<varlistentry><term><option role="nodash">&Dash;&Dash;poolname</option></term>
<listitem><para>The name of the connection pool. When two or more resource
elements point to the same connection pool element, they use the same pool
connections at runtime.</para>
</listitem></varlistentry>
<varlistentry><term><option role="nodash">&Dash;&Dash;enabled</option></term>
<listitem><para>This option determines whether the resource is enabled at
runtime. The default value is true.</para>
</listitem></varlistentry>
<varlistentry><term><option role="nodash">&Dash;&Dash;description</option></term>
<listitem><para>Text providing details about the connector resource.</para>
</listitem></varlistentry>
</variablelist></refsect1>
<refsect1><title>&oper-tt;</title>
<variablelist termlength="medium">
<varlistentry><term><replaceable>jndi_name</replaceable></term><listitem>
<para>the JNDI name of this connector resource.</para>
</listitem></varlistentry>
</variablelist></refsect1>
<refsect1><title>&exam-tt;</title>
<example>
<title>Using the create-connector-resource command</title>
<para>This example shows the usage of this command in the Platform Edition.
</para>
<screen>asadmin> <userinput>create-connector-resource --poolname jms/qConnPool 
--description "creating sample connector resource" jms/qConnFactory</userinput>
Command create-connector-resource executed successfully</screen>
<para>Where jms/qConnFactory is the sample connector resource that is created.
</para>
</example>
<example>
<title>Using the create-connector-resource command</title>
<para>This example shows the usage of this command in the Standard and Enterprise
Editions.</para>
<screen>asadmin> <userinput>create-connector-resource --target server --poolname jms/qConnPool 
--description "creating sample connector resource" jms/qConnFactory</userinput>
Command create-connector-resource executed successfully</screen>
<para>Where jms/qConnFactory is the sample connector resource that is 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="relatedCommand-1"><citerefentry><refentrytitle>delete-connector-resource
</refentrytitle><manvolnum>1</manvolnum></citerefentry></link>, <link linkend="anotherRelatedCommand-1"><citerefentry>
<refentrytitle>list-connector-resources</refentrytitle><manvolnum>1</manvolnum>
</citerefentry></link></para>
</refsect1>
</refentry>
<?Pub *0000005693>
