Administering data access applications

 

These administrative tasks consist primarily of configuring the objects, or resources, through which applications connect with a backend, and tuning those resources to handle the volume of connection requests.

 

Procedure

1. If your application contains Web modules or EJB modules that require access to a backend, configure resources according to your type of EIS:

   • For a relational database, follow the steps outlined in the Configure a JDBC provider and data source topic.

   • For a non-relational database, or another type of EIS such as the Customer Information Control System (CICS), configure a resource adapter and connection factories. The topic Accessing data using J2EE Connector Architecture connectors provides information on setting up these objects.

   When you specify the Java Naming and Directory Interface (JNDI) name for resources, adhere to the following requirements:

   • Do not assign duplicate JNDI names across different resource types (such as data sources versus J2C connection factories or JMS connection factories).

   • Do not assign duplicate JNDI names for multiple resources of the same type in the same scope.

2. Configure an authentication alias for the new Web module resource or EJB module resource only if the application code, rather than WebSphere Application Server, authenticates connections with the backend. This security configuration is called component-managed authorization, and is indicated in the application deployment descriptor as res-auth = Application.

   Container-managed authorization, which is designated as res-auth = Container, indicates that Application Server performs signon for backend connections. The container-managed authentication alias must be specified on the application resource reference. This task can be done during application assembly or deployment, along with mapping the resource reference to a data source or connection factory resource. After application deployment, however, you can alter the container-managed authentication alias using the console. Click Applications > Enterprise Applications > application, and select the link to the appropriate mapping page. For example, if you want to alter the alias of an EJB module resource, you might click 1.x CMP bean data sources or 2.x CMP bean data sources. For a Web module resource, click Resource References.

   Consult the J2EE connector security topic for detailed reference on resource authentication.

3. If your application contains a client module that requires data access, see Configure data access for application clients. In this single configuration process, you can define authentication data for either component-managed or container-managed signon.

4. Specify connection pool settings.

5. Test a connection to the new data source. See the article Test connection service for information on the available methods for testing connections. This article also addresses important data source settings that can affect the accuracy of your test connection results.

6. Set the JDBC trace service. The JDBC trace log information augments the JVM log data for data source failures.

   To activate the trace using the console, consult Enabling trace at server startup. Specify WAS.database as the trace group and select com.ibm.ws.db2.logwriter as the trace string.

7. Gather connection pool statistics by activating the JDBC connection pool counters or the J2C connection pool counters. Alternatively, you can use Performance Monitoring Infrastructure (PMI) method calls to gather connection statistics; consult the article Connection and connection pool statistics.

8. Tune the resources to manage connection volume. Consult the topic Data access tuning parameters.

---

Installing a Resource Adapter Archive (RAR) file

Configure J2EE Connector connection factories in the administrative console

J2EE connector security

Mapping resource references to references

Configure a JDBC provider and data source

Configure data access for application clients using the assembly tool and ACRCT

Resource references

Performing platform-specific tasks for JDBC access

Pretesting pooled connections to ensure validity

Passing client information to a database

About Cloudscape v10.1.x

Verifying the Cloudscape v10.1.x automatic migration

Upgrading Cloudscape manually

Database performance tuning

Data access tuning parameters

Manage resources through JCA lifecycle management operations

Data access problems

JDBC trace configuration

 

Related concepts

Resource adapters
JDBC providers
Data sources
Connection pooling

 

Related tasks

Accessing data using J2EE Connector Architecture connectors

 

Related Reference

Application scoped resources
Data source minimum required settings, by vendor
DB2 tuning parameters