bea.com | products | dev2dev | support | askBEA
 Download Docs   Site Map   Glossary 
Search

WebLogic Server Configuration Reference

 Previous Next Contents Index View as PDF  

JDBCTxDataSource

Syntax

<!ELEMENT JDBCTxDataSource EMPTY >
<!ATTLIST JDBCTxDataSource
   DeploymentOrder            CDATA                    "1000"
   EnableTwoPhaseCommit       (true | false)           "false"
   JNDIName                   CDATA                    #IMPLIED
   Name                       CDATA                    #REQUIRED
   Notes                      CDATA                    #IMPLIED
   PoolName                   CDATA                    #IMPLIED
   RowPrefetchEnabled         (true | false)           "false"
   RowPrefetchSize            CDATA                    "48"
   StreamChunkSize            CDATA                    "256"
   Targets                    CDATA                    #IMPLIED
>

Parent Elements

The JDBCTxDataSource element is a child of the Domain element.

Attributes

Table 26-1 JDBCTxDataSourceMBean Element Attributes

Attribute

Description

Range of Values and Default

Console Label

Deployment-Order

A priority that the server uses to determine when it deploys an item. The priority is relative to other deployable items of the same type. For example, the server prioritizes and deploys all startup classes before it prioritizes and deploys EJBs.

Items with the lowest Deployment Order value are deployed first. There is no guarantee on the order of deployments with equal Deployment Order values. There is no guarantee of ordering across clusters.

Default: 1000

Minimum: 0

Maximum: 2147483647

Deployment Order

Enable-Two-Phase-Commit

When set to true, this attribute allows non-XA JDBC drivers to emulate participation in distributed transactions using JTA.

Use this option if the JDBC connection is the only participant in the transaction and there is no XA compliant JDBC driver available. With more than one resource participating in a transaction where one of them (the JDBC driver) is emulating an XA resource, you may see heuristic failures.

If this TxDataSource is associated with an XA connection pool, or if there is only one resource participating in the distributed transaction, then this setting is ignored.

Default: false

Emulate Two-Phase Commit for non-XA Driver

JNDIName

The JNDI path to where this TxDataSource is bound.

Applications that look up the JNDI path will get a javax.sql.DataSourceinstance that corresponds to this DataSource.


JNDI Name

Name

The name of this configuration. WebLogic Server uses an MBean to implement and persist the configuration.


Name

Notes

Optional information that you can include to describe this configuration.


Notes

Pool-Name

The name of the JDBC connection pool that is associated with this TxDataSource.

Calls from applications to getConnection()on this TxDataSource will return a connection from the associated connection pool.


Pool Name

Row-Prefetch-Enabled

Controls row prefetching between a client and WebLogic Server for each ResultSet. When an external client accesses a database using JDBC through Weblogic Server, row prefetching improves performance by fetching multiple rows from the server to the client in one server access. WebLogic Server will ignore this setting and not use row prefetching when the client and WebLogic Server are in the same JVM.

Default: false

Row Prefetch Enabled

Row-Prefetch-Size

The number of result set rows to prefetch for a client. The optimal value depends on the particulars of the query. In general, increasing this number will increase performance, until a particular value is reached. At that point further increases do not result in any significant performance increase. Very rarely will increased performance result from exceeding 100 rows. The default value should be reasonable for most situations.

Default: 48

Minimum: 2

Maximum: 65536

Row Prefetch Size

Stream-Chunk-Size

Data chunk size for steaming datatypes. Streaming datatypes (for example resulting from a call to getBinaryStream()) will be pulled in StreamChunkSize sized chunks from the WebLogic Server to the client as needed.

Default: 256

Minimum: 1

Maximum: 65536

Units: bytes

Stream Chunk Size

Targets

The targets in the current domain on which this item can be deployed.


Targets


 

 

Back to Top Previous Next