<!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-iiop-listener-1">
<refmeta><refentrytitle>create-iiop-listener</refentrytitle><manvolnum>1</manvolnum>&metainfo;
</refmeta>
<refnamediv><indexterm><primary sortas="create-iiop-listener ">create-iiop-listener &mdash;
adds an IIOP listener</primary></indexterm><indexterm><primary sortas="adds the IIOP listener">
adds an IIOP listener &mdash; create-iiop-listener</primary></indexterm><refname>
create-iiop-listener</refname><refpurpose>adds an IIOP listener</refpurpose>
</refnamediv>
<refsynopsisdiv><title>&synp-tt;</title>
<cmdsynopsis><command>create-iiop-listener</command>&synopsis-common;
<arg choice="plain">&Dash;&Dash;listeneraddress <replaceable>address</replaceable></arg>
<arg>&Dash;&Dash;iiopport <replaceable>1072</replaceable></arg><arg>&Dash;&Dash;securityenabled=<replaceable>
false</replaceable></arg><arg>&Dash;&Dash;enabled=<replaceable>true</replaceable></arg>
<arg><option role="nodash">&Dash;&Dash;property (<replaceable>name</replaceable>=<replaceable>
value</replaceable>)[:<replaceable>name</replaceable>=<replaceable>value</replaceable>]*
</option></arg><arg>&Dash;&Dash;target <replaceable>server</replaceable></arg>
<arg choice="plain"><replaceable>listener_id</replaceable></arg>
</cmdsynopsis></refsynopsisdiv>
<refsect1><title>&desc-tt;</title>
<para>The <command>create-iiop-listener</command> command creates an IIOP
listener. 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;listeneraddress</option></term>
<listitem><para>Either the IP address or the hostname (resolvable by DNS).
</para>
</listitem></varlistentry>
<varlistentry><term><option role="nodash">&Dash;&Dash;iiopport</option></term>
<listitem><para>The IIOP port number. The default value is 1072.</para>
</listitem></varlistentry>
<varlistentry><term><option role="nodash">&Dash;&Dash;securityenabled</option></term>
<listitem><para>If set to true, the IIOP listener runs SSL. You can turn SSL2
or SSL3 ON or OFF and set ciphers using an SSL element. The security setting
globally enables or disables SSL by making certificates available to the server
instance. The default value is false.</para>
</listitem></varlistentry>
<varlistentry><term><option role="nodash">&Dash;&Dash;enabled</option></term>
<listitem><para>If set to true, the IIOP listener is enabled at runtime.</para>
</listitem></varlistentry>
<varlistentry><term><option role="nodash">&Dash;&Dash;property</option></term>
<listitem><para>Optional attribute name/value pairs for configuring the IIOP
listener.</para>
</listitem></varlistentry>
<varlistentry><term><option role="nodash">&Dash;&Dash;target</option></term>
<listitem><para>&se-ee-only; Specifies the target for which you are creating
the IIOP listener. Valid values are<itemizedlist>
<listitem><para><literal>server</literal>, which creates the listener for
the default server instance <literal>server</literal> and is the default value
</para>
</listitem>
<listitem><para><replaceable>configuration_name</replaceable>, which creates
the listener for the named configuration</para>
</listitem>
<listitem><para><replaceable>cluster_name</replaceable>, which creates the
listener for every server instance in the cluster</para>
</listitem>
<listitem><para><replaceable>stand-alone_instance_name</replaceable>, which
creates the listener for a particular stand-alone server instance</para>
</listitem>
</itemizedlist></para>
</listitem></varlistentry>
</variablelist></refsect1>
<refsect1><title>&oper-tt;</title>
<variablelist termlength="medium">
<varlistentry><term><replaceable>listener_id</replaceable></term><listitem>
<para>A unique identifier for the IIOP listener to be created.</para><?Pub Caret>
</listitem></varlistentry>
</variablelist></refsect1>
<refsect1><title>&exam-tt;</title>
<example>
<title>Using the create-iiop-listener command</title>
<para>The following command creates an IIOP listener named <filename>sample_iiop_listener
</filename>:</para>
<screen>asadmin> <userinput>create-iiop-listener --user admin 
--passwordfile passwords.txt --host host1 --port 4848 
--listeneraddress 192.168.1.100 --iiopport 1400 sample_iiop_listener</userinput>
Command create-iiop-listener executed successfully.</screen>
</example>
<example>
<title>Using the create-iiop-listener command with the target option.</title>
<para>The following command creates an IIOP listener named <literal>iiop_listener_2
</literal> for the cluster <literal>mycluster</literal>. It uses the target
option. &se-ee-only;</para>
<screen>asadmin> <userinput>create-iiop-listener --user admin 
--passwordfile passwords.txt --host host1 --port 4849 
--listeneraddress 0.0.0.0 --iiopport 1401 --target mycluster iiop_listener_2
</userinput>
Command create-iiop-listener executed successfully.</screen>
</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-iiop-listener-1"><citerefentry><refentrytitle>
delete-iiop-listener</refentrytitle><manvolnum>1</manvolnum></citerefentry></link>, <link
linkend="list-iiop-listeners-1"><citerefentry><refentrytitle>list-iiop-listeners
</refentrytitle><manvolnum>1</manvolnum></citerefentry></link>, <link linkend="create-ssl-1"><citerefentry>
<refentrytitle>create-ssl</refentrytitle><manvolnum>1</manvolnum></citerefentry></link></para>
</refsect1>
</refentry>
<?Pub *0000006378>
