<!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 synopsis-common SYSTEM "synopsis-common.sgm">
<!ENTITY options-common SYSTEM "options-common.sgm">
<!ENTITY Dash "&ndash;">
<!ENTITY % commonents SYSTEM "smancommon.ent">
%commonents;
<!ENTITY % booktitles SYSTEM "booktitles.ent">
%booktitles;
]>
<?Pub UDT _bookmark _target>
<?Pub Inc>
<refentry id="create-threadpool-1">
<refmeta><refentrytitle>create-threadpool</refentrytitle><manvolnum>1</manvolnum>&metainfo;
</refmeta>
<refnamediv><refname>create-threadpool</refname><refpurpose>adds a threadpool
</refpurpose></refnamediv>
<refsynopsisdiv><title>&synp-tt;</title>
<cmdsynopsis><command>create-threadpool</command>&synopsis-common;
<arg>&Dash;&Dash;target <replaceable>target_name</replaceable></arg><arg>&Dash;&Dash;maxthreadpoolsize <replaceable>
max_thread_pool_size</replaceable></arg><arg>&Dash;&Dash;minthreadpoolsize <replaceable>
min_thread_pool_size</replaceable></arg><arg>&Dash;&Dash;idletimeout <replaceable>
idle_thread_timeout_in_seconds</replaceable></arg><arg>&Dash;&Dash;workqueues <replaceable>
number_work_queues</replaceable></arg><arg choice="plain"><replaceable>threadpool_id
</replaceable></arg>
</cmdsynopsis></refsynopsisdiv>
<refsect1><title>&desc-tt;</title>
<para>The <command>create-threadpool</command> command creates a threadpool
with the specified name. You can specify maximum and minimum number of threads
in the pool, the number of work queues, and the idle timeout of a thread.
The created thread pool can be used for servicing IIOP requests and for resource
adapters to service work management requests. Please note that a created thread
pool can be used in multiple resource adapters. 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 specifies the target on which you are creating
the threadpool. Valid values are<itemizedlist>
<listitem><para><literal>server</literal>, which creates the threadpool for
the default server instance <literal>server</literal> and is the default value
</para>
</listitem>
<listitem><para><replaceable>configuration_name</replaceable>, which creates
the threadpool for the named configuration</para>
</listitem>
<listitem><para><replaceable>cluster_name</replaceable>, which creates the
threadpool for every server instance in the cluster</para>
</listitem>
<listitem><para><replaceable>instance_name</replaceable>, which creates the
threadpool for a particular server instance</para>
</listitem>
</itemizedlist></para>
</listitem><?Pub Caret1></varlistentry>
<varlistentry><term><option>-maxthreadpoolsize</option></term><listitem><para>
Maximum number of threads in the threadpool servicing requests in this queue.
This is the upper bound on the number of threads that exist in the threadpool.
</para>
</listitem></varlistentry>
<varlistentry><term><option>-minthreadpoolsize</option></term><listitem><para>
Minimum number of threads in the threadpool servicing requests in this queue.
These are created up front when the threadpool is instantiated.</para>
</listitem></varlistentry>
<varlistentry><term><option>-idletimeout</option></term><listitem><para>Idle
threads are removed from the pool after this time.</para>
</listitem></varlistentry>
<varlistentry><term><option>-workqueues</option></term><listitem><para>Identifies
the total number of work queues serviced by this threadpool.</para>
</listitem></varlistentry>
</variablelist></refsect1>
<refsect1><title>&oper-tt;</title>
<variablelist termlength="medium">
<varlistentry><term><replaceable>threadpool_id</replaceable></term><listitem>
<para>an ID for the work queue; for example, thread-pool-1, thread-pool-2,
etc.</para>
</listitem></varlistentry>
</variablelist></refsect1>
<refsect1><title>&exam-tt;</title>
<example>
<title>Using create-threadpool Command</title>
<screen>asadmin> <userinput>create-threadpool --user admin1 
--passwordfile password.txt --maxthreadpoolsize 100 
--minthreadpoolsize 20 --idletimeout 2 --workqueues 100 threadpool-1</userinput>
Command create-threadpool executed successfully</screen>
</example>
</refsect1>
<refsect1><title>EXIT STATUS</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-threadpool-1"><citerefentry><refentrytitle>delete-threadpool
</refentrytitle><manvolnum>1</manvolnum></citerefentry></link>, <link linkend="list-threadpools-1"><citerefentry>
<refentrytitle>list-threadpools</refentrytitle><manvolnum>1</manvolnum></citerefentry></link></para>
</refsect1>
</refentry>
<?Pub *0000005082>
