InfoCenter Home >
6: Administer applications >
6.6: Tools and resources quick reference >
6.6.42: Administering J2C related administrative resources (overview) >
6.6.42.0: Properties of J2C Resource Adapters >
6.6.42.0: Properties of J2C connection factories

6.6.42.0: Properties of J2C connection factories

Key:
Property name in the Java-based administrative console Applies to Java administrative console of Advanced Edition Version 4.0
Property name in the Web-based administrative console Applies to Web administrative console of Advanced Single Server Edition Version 4.0
Property name in the application client resource configuration tool Applies to Application Client Resource Configuration Tool
Connection Timeout Property name in the Java-based administrative console
If the maximum number of connections has been reached, the connection will wait for [Connection Timeout] milliseconds before aborting and throwing a ResourceAllocationException.  If the maximum number of connections has not been reached, or is set to 0, Connection Timeout will not be used.

If Connection Timeout is 0, the pool manager will wait indefinitely.

Description Property name in the Java-based administrative console
An optional description for your administrative records
Name Property name in the Java-based administrative console
Logical name for the connection factory, to be displayed in administrative tools
J2C Connection Factory Property name in the Java-based administrative console
One set of connection configuration values. Application components, such as enterprise beans, have resource-ref descriptors that refer to a specific connection factory, not to the resource adapter.

You can think of the connection factory as a holder of a list of configuration properties. In addition to the arbitrary set of configuration properties defined by the vendor of the resource adapter, there are several standard configuration properties that apply to the connection factory. These standard properties are used by the J2C connection pool manager in the application server runtime and are not known by the vendor supplied resource adapter code.

J2C Resource Adapter Property name in the Java-based administrative console
This read-only field identifies the J2C Resource Adapter on which this J2C Connection Factory is based.
JNDI binding path Property name in the Java-based administrative console
The JNDI name that will be used to bind the J2C Connection Factory into the application server's name space.  The default value for this field is eis/Name, where Name is the logical name of the connection factory.
Maximum Connections Property name in the Java-based administrative console
The maximum number of managed connections that can be created by a particular ManagedConnectionFactory. After this number is reached, no new connections are created and either the requester waits for the Connection Timeout or a ResourceAllocationException is thrown. If Maximum Connections is set to 0. The number of connections can grow indefinitely. Maximum Connections must be larger than or equal to Minimum Connections.
Minimum Connections Property name in the Java-based administrative console
The minimum number of managed connections to maintain. If this number is reached, the garbage collector will not discard any managed connections. Note, if the actual number of connections is lower than the value specified by the minimum connections settings, no attempt will be made to increase the number of connections to the minimum. Minimum Connections must be less than or equal to Maximum Connections.
Pool Name Property name in the Java-based administrative console
The name used by the pool manager to group managed connections created by different ManagedConnectionFactories.
Reap Time Property name in the Java-based administrative console
Number of seconds between runs of the garbage collector. The garbage collector discards all connections that have been unused for the value specified by the unused timeout.

To disable the garbage collector, set the reap time to 0 or set the unused timeout to 0.

Re-Authentication Support Property name in the Java-based administrative console
Whether the resource adapter supports re-authentication of existing managed connection instances
Subpool Name Property name in the Java-based administrative console
The name used by the pool manager to group managed connections created by different ManagedConnectionFactories within a particular pool.
Unused Timeout Property name in the Java-based administrative console
Number of milliseconds after which an unused connection is discarded. Setting this value to 0 disables the garbage collector.
Go to previous article: Properties of J2C Resource Adapters Go to next article: Administering J2C resources with the Java administrative console

 

 
Go to previous article: Properties of J2C Resource Adapters Go to next article: Administering J2C resources with the Java administrative console