user manual

v
Key cache size . . . . . . . . . . . . . 194
Chapter 19
Transaction management 195
Understanding transactions . . . . . . . . . . 195
Characteristics of transactions . . . . . . . 195
Transaction support . . . . . . . . . . . . 196
Transaction manager services . . . . . . . . 197
Distributed transactions and two-phase commit
197
When to use two-phase commit transactions198
EJBs and 2PC transactions . . . . . . . . 199
Example runtime scenarios . . . . . . . 201
Declarative transaction management in Enterprise
JavaBeans . . . . . . . . . . . . . . . . . . 203
Understanding bean-managed and container-
managed transactions . . . . . . . . . . 204
Local and Global transactions . . . . . . . 205
Transaction attributes . . . . . . . . . . . 206
Programmatic transaction management using JTA
APIs . . . . . . . . . . . . . . . . . . . . . 207
JDBC API Modifications . . . . . . . . . . . . 208
Modifications to the behavior of the JDBC API.
208
Overridden JDBC methods. . . . . . . . . 208
Handling of EJB exceptions . . . . . . . . . . 209
System-level exceptions . . . . . . . . . . 210
Application-level exceptions . . . . . . . . 210
Handling application exceptions . . . . . . 210
Transaction rollback . . . . . . . . . . . 211
Options for continuing a transaction . . 211
Chapter 20
Message-Driven Beans and JMS 213
JMS and EJB . . . . . . . . . . . . . . . . . 213
EJB 2.0 Message-Driven Bean (MDB) . . . 214
Client View of an MDB . . . . . . . . . . . . 214
Naming Support and Configuration . . . . . . 215
Connecting to JMS Connection Factories from
MDBs . . . . . . . . . . . . . . . . . . . 215
Clustering of MDBs . . . . . . . . . . . . . . 217
Error Recovery . . . . . . . . . . . . . . . . 218
Rebinding . . . . . . . . . . . . . . . . . 218
Redelivered messages . . . . . . . . . . . 218
MDBs and transactions . . . . . . . . . . . . 220
Chapter 21
Connecting to Resources with BES:
using the Definitions Archive (DAR)
221
JNDI Definitions Module . . . . . . . . . . . . 222
Migrating to DARs from previous versions of
Borland Enterprise Server . . . . . . . . . 223
Creating and Deploying a new JNDI Definitions
Module . . . . . . . . . . . . . . . . . . . . 223
Disabling and Enabling a JNDI Definitions Module .
224
Packaging JNDI Definitions Modules in an
application EAR . . . . . . . . . . . . . . . . 224
JNDI service provider for hosting resource factories
224
Configuring persistent storage locations for
Serial Context . . . . . . . . . . . . . . . 225
Chapter 22
Using JDBC 227
Configuring JDBC Datasources. . . . . . . . . 228
Deploying Driver Libraries . . . . . . . . . . 231
Defining the Connection Pool Properties for a
JDBC Datasource . . . . . . . . . . . . . . . 232
Getting debug output . . . . . . . . . . . . . . 238
Descriptions of Borland Enterprise Server's pooled
connection states . . . . . . . . . . . . . . . 238
Support for older JDBC 1.x drivers . . . . . . .239
Advanced Topics for Defining JDBC Datasources .
240
Connecting to JDBC Resources from Application
Components. . . . . . . . . . . . . . . . . . 242
Chapter 23
Using JMS 245
Configuring JMS Connection Factories and
Destinations . . . . . . . . . . . . . . . . . . 246
Queue creation . . . . . . . . . . . . . . . 247
Enabling Sonic. . . . . . . . . . . . . . . . 247
JMS and Transactions . . . . . . . . . . . . . 247
Enabling the JMS services security. . . . . . . 249
Advanced Concepts for Defining JMS Connection
Factories. . . . . . . . . . . . . . . . . . . . 249
Connecting to JMS Connection Factories from
Application Components . . . . . . . . . . . 250
Connecting to JMS Connection Factories from
components other than MDBs . . . . . . . 250