Configuring Resource Adapters; Principles; Description And Examples - Red Hat APPLICATION SERVER - JONAS Manual

This chapter describes how to use resource adapters with JOnAS.

41.1. Principles

Resource Adapters are packaged for deployment in a standard Java programming language Archive
file called a RAR file (Resource ARchive), which is described in the J2EE Connector Architecture
specification.
The standard method of creating the
description see Section 6.7 RAConfig.

41.2. Description and Examples

The
jonas-ra.xml
ging, pooling, JDBC connections, and RAR configuration property values.
Deployment Tags:
•
jndiname: (Required) Name the RAR will be registered as. This value will be used in the
•
resource-ref section of an EJB.
rarlink: The JNDI Name of a base RAR file. Useful for deploying multiple connection factories
•
without having to deploy the complete RAR file again. When this is used, the only entry in the
RAR is
META-INF/jonas-ra.xml
native-lib: Directory where additional files in the RAR should be deployed.
•
Logging Tags:
•
log-enabled: Determines if logging should be enabled for the RAR.
•
log-topic: Log topic to use for the PrintWriter logger, which allows a separate handler for each
•
deployed RAR.
Pooling Tags:
•
pool-init: Initial size of the managed connection pool.
•
pool-min: Minimum size of the managed connection pool.
•
pool-max: Maximum size of the managed connection pool. Value of -1 is unlimited.
•
pool-max-age: Maximum number of milliseconds to keep the managed connection in the pool.
•
Value of 0 is an unlimited amount of time.
pstmt-max: Maximum number of PreparedStatements per managed connection in the pool. Only
•
required with JDBC resource adapters. Value of 0 is unlimited; -1 disables the cache.
JDBC Connection Tags: Only valid with a Connection implementation of java.sql.Connection.
•
Configuring Resource Adapters
jonas-ra.xml
contains JOnAS-specific information describing deployment information, log-
.
file is by using the RAConfig tool, for a complete
Chapter 41.