web server - Borland Technical Publications

Connection management
Configuring connection properties
The following connection pool properties can be set:
Property Value type Description Default
wait-timeout Integer The number of seconds to wait for a
free connection when maximumcapacity
connections are already
opened. When using the maximumcapacity
property and the pool is at
its max and can't serve any more
connections, the threads looking for
connections end up waiting for the
connection(s) to become available
for a long time if the wait time is
unbounded (set to 0 seconds). You
can set the wait-timeout period to
suit your needs.
30
busy-timeout Integer The number of seconds to wait
before a busy connection is
released. If a connection is busy for
a long time, the application using it
may have hung and be unable to
release the connection. This timeout
will ensure that connections will be
timed out when they have been busy
for much longer than necessary.
idle-timeout Integer A pooled connection remaining in an
idle state for a period of time longer
than this timeout value should be
closed to conserve resources. All
idle connections are checked for
idle-timeout expiration every 60
seconds. The value of the idletimeout
is given in seconds. A value
of 0 (zero) indicates that connection
cleanup is disabled.
maximum-capacity Integer Identifies the maximum number of
managed connections which
VisiConnect will allow. Throws
ResourceAllocationException when
requests for newly allocated
managed connections go beyond
this limit.
The following properties are no longer used and are now ignored by VisiConnect. They
are replaced in BES 6.5 by the pool properties busy-timeout, idle-timeout, and waittimeout,
listed in the table above. You do not have to delete the old-style properties
from ra-borland.xml, but they will no longer have any effect.
Unused Pool properties
600 (ten minutes)
600 (ten minutes)
10
Table 27.1
Unused pool properties
Property Default Description
initial-capacity 1 Identifies the initial number of managed
connections which VisiConnect will attempt to
obtain during deployment.
capacity-delta 1 Identifies the number of additional managed
connections which the VisiConnect will attempt to
obtain during resizing of the maintained connection
pool.
Chapter 27: Using VisiConnect 259