<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE html
PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html lang="en-us" xml:lang="en-us">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
<meta name="security" content="public" />
<meta name="Robots" content="index,follow" />
<meta http-equiv="PICS-Label" content='(PICS-1.1 "http://www.icra.org/ratingsv02.html" l gen true r (cz 1 lz 1 nz 1 oz 1 vz 1) "http://www.rsac.org/ratingsv01.html" l gen true r (n 0 s 0 v 0 l 0) "http://www.classify.org/safesurf/" l gen true r (SS~~000 1))' />
<meta name="DC.Type" content="reference" />
<meta name="DC.Title" content="AS400JDBCConnectionPool" />
<meta name="abstract" content="" />
<meta name="description" content="" />
<meta name="copyright" content="(C) Copyright IBM Corporation 2006" />
<meta name="DC.Rights.Owner" content="(C) Copyright IBM Corporation 2006" />
<meta name="DC.Format" content="XHTML" />
<meta name="DC.Identifier" content="jdbcconnpool" />
<meta name="DC.Language" content="en-us" />
<!-- All rights reserved. Licensed Materials Property of IBM -->
<!-- US Government Users Restricted Rights -->
<!-- Use, duplication or disclosure restricted by -->
<!-- GSA ADP Schedule Contract with IBM Corp. -->
<link rel="stylesheet" type="text/css" href="./ibmdita.css" />
<link rel="stylesheet" type="text/css" href="./ic.css" />
<title>AS400JDBCConnectionPool</title>
</head>
<body id="jdbcconnpool"><a name="jdbcconnpool"><!-- --></a>
<!-- Java sync-link --><script language="Javascript" src="../rzahg/synch.js" type="text/javascript"></script>
<h1 class="topictitle1">AS400JDBCConnectionPool</h1>
<div><p></p>
<div class="section"><p>The <a href="javadoc/com/ibm/as400/access/AS400JDBCConnectionPool.html#NAVBAR_TOP"> AS400JDBCConnectionPool</a> class represents a pool of <a href="javadoc/com/ibm/as400/access/AS400JDBCConnection.html#NAVBAR_TOP"> AS400JDBCConnection</a> objects that are available for use
by a Java™ program
as part of IBM<sup>®</sup> Toolbox
for Java support
for the JDBC 2.0 Optional Package API.</p>
<p>You can use an <a href="javadoc/com/ibm/as400/access/AS400JDBCConnectionPoolDataSource.html#NAVBAR_TOP"> AS400JDBCConnectionPoolDataSource</a> to specify properties
for the connections that are created in the pool, as in the following <a href="#jdbcconnpool__jdbcconex">example</a>.</p>
<p>You cannot change the
connection pool data source after you have requested a connection and the
pool is in use. To reset the connection pool data source, first call <a href="javadoc/com/ibm/as400/access/AS400JDBCConnectionPool.html#CLOSE()"> close()</a> on the pool.</p>
<p>Return connections to an
AS400JDBCConnectionPool by using <a href="javadoc/com/ibm/as400/access/AS400JDBCConnection.html#CLOSE()"> close()</a> on the AS400JDBCConnection object.</p>
<div class="note"><span class="notetitle">Note:</span> When
connections are not returned to the pool, the connection pool continues to
grow in size and connections are not reused.</div>
<p>Set properties on the
pool by using methods inherited from <a href="javadoc/com/ibm/as400/access/ConnectionPool.html"> ConnectionPool</a>. Some of the properties that you can
set include:</p>
<ul><li>maximum number of connections to allow in the pool</li>
<li>maximum lifetime of a connection</li>
<li>maximum inactivity time of a connection.</li>
</ul>
<p>You can also register AS400JDBCConnectionPoolDataSource objects by
using a Java Naming and Directory Interface<sup>(TM)</sup> (JNDI)
service provider. For more information on JNDI service providers, see <a href="reflearn.htm#reflearn">IBM Toolbox for Java reference links</a>.</p>
</div>
<div class="section" id="jdbcconnpool__jdbcconex"><a name="jdbcconnpool__jdbcconex"><!-- --></a><h4 class="sectiontitle">Example: Using connection pool</h4><p>The
following example gets a connection pool data source from JNDI and uses it
to create a connection pool with 10 connections:</p>
<pre> // Obtain an AS400JDBCConnectionPoolDataSource object from JNDI
// (assumes JNDI environment is set).
Context context = new InitialContext(environment);
AS400JDBCConnectionPoolDataSource datasource =
(AS400JDBCConnectionPoolDataSource)context.lookup("jdbc/myDatabase");
// Create an AS400JDBCConnectionPool object.
AS400JDBCConnectionPool pool = new AS400JDBCConnectionPool(datasource);
// Adds 10 connections to the pool that can be used by the
// application (creates the physical database connections based on
// the data source).
pool.fill(10);
// Get a handle to a database connection from the pool.
Connection connection = pool.getConnection();
... Perform miscellaneous queries/updates on the database.
// Close the connection handle to return it to the pool.
connection.close();
... Application works with some more connections from the pool.
// Close the pool to release all resources.
pool.close();</pre>
</div>
</div>
</body>
</html>