<!--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-threadpool-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-threadpool.1 1.9 07/04/25 SMI; -->
<refmeta><refentrytitle>create-threadpool</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>
<refname>create-threadpool</refname><refpurpose>adds a threadpool</refpurpose>
</refnamediv>
<refsynopsisdiv><title></title>
<synopsis><command>create-threadpool</command> &synopsis-common; [<option
role="double-dash">target</option> <replaceable>target_name</replaceable>]
 [<option role="double-dash">maxthreadpoolsize</option> <replaceable>max_thread_pool_size
</replaceable>]
 [<option role="double-dash">minthreadpoolsize</option> <replaceable>min_thread_pool_size
</replaceable>]
 [<option role="double-dash">idletimeout</option> <replaceable>idle_thread_timeout_in_seconds
</replaceable>]
 [<option role="double-dash">workqueues</option> <replaceable>number_work_queues</replaceable>] <replaceable>
threadpool_id</replaceable></synopsis>
</refsynopsisdiv>
<refsect1 role="description"><title></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 role="options"><title></title>
<variablelist termlength="medium">&options-common;
<varlistentry><term><option role="double-dash">target</option></term>
<listitem><para>This option specifies the target on which you are creating
the threadpool. Valid values are</para>
<itemizedlist>
<listitem><para><literal>server</literal>&hyphen; Specifies the default server
instance as the target for creating the threadpool.</para></listitem>
<listitem><para><replaceable>configuration_name</replaceable>&hyphen; Specifies
a particular configuration as the target for creating the threadpool.</para>
</listitem>
<listitem><para><replaceable>cluster_name</replaceable>&hyphen; Specifies
a particular cluster as the target for creating the threadpool.</para>
</listitem>
<listitem><para><replaceable>instance_name</replaceable>&hyphen; Specifies
a particular server instance as the target<?Pub Caret> for creating the threadpool.
</para></listitem>
</itemizedlist>
</listitem>
</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 role="operands"><title></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 role="examples"><title></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 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-threadpool-1">delete-threadpool(1)
</olink>, <olink targetdoc="ASREFMAN" targetptr="list-threadpools-1">list-threadpools(1)
</olink></para>
</refsect1>
</refentry>
<?Pub *0000005222 0>
