You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@commons.apache.org by tv...@apache.org on 2026/09/01 11:57:12 UTC
(commons-jcs) 02/03: Document scheduled pool configuration
This is an automated email from the ASF dual-hosted git repository.
asf-gitbox-commits pushed a commit to branch master
in repository https://gitbox.apache.org/repos/asf/commons-jcs.git
commit e830edcbb9d7bd94760b30e6aec94f1677e860e9
Author: Thomas Vandahl <tv...@apache.org>
AuthorDate: Tue Sep 1 13:56:43 2026 +0200
Document scheduled pool configuration
---
src/site/xdoc/BasicJCSConfiguration.xml | 30 +++++++++++++++++++++---------
src/site/xdoc/BlockDiskCache.xml | 2 ++
2 files changed, 23 insertions(+), 9 deletions(-)
diff --git a/src/site/xdoc/BasicJCSConfiguration.xml b/src/site/xdoc/BasicJCSConfiguration.xml
index 34e3019a..c45f4dde 100644
--- a/src/site/xdoc/BasicJCSConfiguration.xml
+++ b/src/site/xdoc/BasicJCSConfiguration.xml
@@ -103,14 +103,27 @@ jcs.auxiliary.LTCP.attributes.TcpListenerPort=1110
jcs.auxiliary.LTCP.attributes.PutOnlyMode=false
]]></source>
<p>
- See the TCP Lateral documentation for more information. If you
- want to set up <code>testCache1</code> to use this, then change
- the definition to:
+ See the <a href="LateralTCPProperties.html">TCP Lateral documentation</a>
+ for more information. If you want to set up <code>testCache1</code>
+ to use this, then change the definition to:
</p>
<source><![CDATA[
jcs.region.testCache1=DC,LTCP
]]></source>
</subsection>
+ <subsection name="Scheduler pool configuration">
+ <p>
+ JCS uses a central scheduler thread pool to execute scheduled
+ tasks. This pool uses a default thread count of 4 and a thread
+ priority of <code>Thread.MIN_PRIORITY</code>. If you want to
+ adjust this, add the following section
+ </p>
+ <source><![CDATA[
+scheduler_pool.default.maximumPoolSize=16
+# Thread.NORM_PRIORITY
+scheduler_pool.default.threadPriority=5
+ ]]></source>
+ </subsection>
<subsection name="A few comments on configuration">
<p>
Auxiliary definitions are like log4j appenders, they are defined
@@ -120,10 +133,6 @@ jcs.region.testCache1=DC,LTCP
The order of configuration file is unimportant, though you
should try to keep it organized for your own sake.
</p>
- <p>
- Configuration is being refactored and is subject to change. It
- should only become easier.
- </p>
</subsection>
<subsection name="The complete file">
<p>
@@ -131,12 +140,10 @@ jcs.region.testCache1=DC,LTCP
</p>
<source><![CDATA[
# DEFAULT CACHE REGION
-
jcs.default=DC,LTCP
jcs.default.cacheattributes.MaxObjects=1000
# PRE-DEFINED CACHE REGIONS
-
jcs.region.testCache1=DC,LTCP
jcs.region.testCache1.cacheattributes.MaxObjects=1000
jcs.region.testCache1.cacheattributes.UseMemoryShrinker=true
@@ -157,6 +164,11 @@ jcs.auxiliary.LTCP=
jcs.auxiliary.LTCP.attributes.TcpServers=localhost:1111
jcs.auxiliary.LTCP.attributes.TcpListenerPort=1110
jcs.auxiliary.LTCP.attributes.PutOnlyMode=false
+
+# SCHEDULER POOL CONFIGURATION
+scheduler_pool.default.maximumPoolSize=16
+# Thread.NORM_PRIORITY
+scheduler_pool.default.threadPriority=5
]]></source>
</subsection>
</section>
diff --git a/src/site/xdoc/BlockDiskCache.xml b/src/site/xdoc/BlockDiskCache.xml
index 0d302561..9f307949 100644
--- a/src/site/xdoc/BlockDiskCache.xml
+++ b/src/site/xdoc/BlockDiskCache.xml
@@ -158,6 +158,8 @@ thread_pool.default.keepAliveTime=PT5M50S
#RUN ABORT DISCARDOLDEST DISCARD
thread_pool.default.whenBlockedPolicy=RUN
thread_pool.default.startUpSize=4
+# Thread.NORM_PRIORITY
+thread_pool.default.threadPriority=5
# Disk Cache pool
thread_pool.disk_cache_event_queue.useBoundary=false