<!--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-iiop-listener-1">
<!-- @(#)create-iiop-listener.1 1.11 07/07/11 SMI; -->
<refmeta><refentrytitle>create-iiop-listener</refentrytitle><manvolnum>1</manvolnum>
<refmiscinfo class="date">11 Jul 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-iiop-listener</primary></indexterm>
<indexterm><primary>adds an IIOP listener</primary></indexterm>
<refname>create-iiop-listener</refname><refpurpose>adds an IIOP listener</refpurpose>
</refnamediv>
<refsynopsisdiv><title></title>
<synopsis><command>create-iiop-listener</command> &synopsis-common; <option
role="double-dash">listeneraddress</option> <replaceable>address</replaceable>
 [<option role="double-dash">iiopport</option> <replaceable>iiop-port-number</replaceable>] [<option
role="double-dash">securityenabled</option>=<replaceable>false</replaceable>]
 [<option role="double-dash">enabled</option>=<replaceable>true</replaceable>] [<option
role="double-dash">property</option> (<replaceable>name</replaceable>=<replaceable>
value</replaceable>)[:<replaceable>name</replaceable>=<replaceable>value</replaceable>]*]
 [<option role="double-dash">target</option> <replaceable>server</replaceable>] <replaceable>
listener_id</replaceable></synopsis>
</refsynopsisdiv>
<refsect1 role="description"><title></title>
<para>The <command>create-iiop-listener</command> command creates an IIOP
listener. This command is supported in remote mode only.</para>
</refsect1>
<refsect1 role="options"><title></title>
<variablelist termlength="wholeline">&options-common;
<varlistentry><term><option role="double-dash">listeneraddress</option></term>
<listitem><para>Either the IP address or the hostname (resolvable by DNS).</para>
</listitem>
</varlistentry>
<varlistentry><term><option role="double-dash">iiopport</option></term>
<listitem><para>The IIOP port number. The default value is 1072.</para>
</listitem>
</varlistentry>
<varlistentry><term><option role="double-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="double-dash">enabled</option></term>
<listitem><para>If set to true, the IIOP listener is enabled at runtime.</para>
</listitem>
</varlistentry>
<varlistentry><term><option role="double-dash">property</option></term>
<listitem><para>Optional attribute name/value pairs for configuring the IIOP
listener.</para>
</listitem>
</varlistentry>
<varlistentry><term><option role="double-dash">target</option></term>
<listitem><para>&se-ee-only; Specifies the target for which you are creating
the IIOP listener. Valid values are</para>
<itemizedlist>
<listitem><para><literal>server</literal>&hyphen; Specifies the default server
instance as the target for creating the listener. <literal>server</literal> is
the default server instance 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 IIOP listener.</para>
</listitem>
<listitem><para><replaceable>cluster_name</replaceable>&hyphen; Specifies
all server instances of a particular cluster as the target for creating the
IIOP listener.</para></listitem>
<listitem><para><replaceable>stand-alone_instance_name</replaceable>&hyphen;
Specifies a particular server instance as the target for creating the IIOP
listener.</para></listitem>
</itemizedlist>
</listitem>
</varlistentry>
</variablelist>
</refsect1>
<refsect1 role="operands"><title></title>
<variablelist termlength="medium">
<varlistentry><term><replaceable>listener_id</replaceable></term>
<listitem><para>A unique identifier for the IIOP listener to be created.</para>
</listitem>
</varlistentry>
</variablelist>
</refsect1>
<refsect1 role="examples"><title></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 4848 
--listeneraddress 0.0.0.0 --iiopport 1401
--target<?Pub Caret> mycluster iiop_listener_2</userinput>
Command create-iiop-listener 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-iiop-listener-1">delete-iiop-listener(1)
</olink>, <olink targetdoc="asrefman" targetptr="list-iiop-listeners-1">list-iiop-listeners(1)
</olink>, <olink targetdoc="asrefman" targetptr="create-ssl-1">create-ssl(1)</olink></para>
</refsect1>
</refentry>
<?Pub *0000006078 0>
