Default Java Persistence API settings

The Java™ Persistence API (JPA) specification requires a default provider to be defined. If you have applications that use JPA, it is recommended you use this page to provide default values. To increase the portability of your applications, you can use this page to configure the default JPA settings for applications running on this server instead of defining the <provider> element in each persistence unit in your applications. The JPA settings defined here are used for the persistence unit of an application only when the application does not define the JPA settings for that persistence unit.

Avoid trouble: Application JPA settings always override the settings on this page.

To view this administrative console page, click Servers > Server types > WebSphere application servers > server > Container Services > Default Java Persistence API settings.

Default persistence provider

Specify the default persistence provider for the application server container. The default persistence provider can be selected either from a list of providers that are included with the product or a user-specified alternate persistence provider.

Select a persistence provider from the product list or specify a fully package qualified JPA implementation class name of an alternate persistence provider.

Default: com.ibm.websphere.persistence.PersistenceProviderImpl

Avoid trouble: If an alternate persistence provider is specified as the default, make sure the alternate persistence provider is created in the server. See the topic on using a third-party persistence provider.

Default Java Transaction API (JTA) data source Java Naming and Directory Interface (JNDI) name

Specify the default JTA data source used by persistence units for the application server container.

Select the JNDI name for the data source from the drop down box. The JTA data sources that are currently configured and visible to the application server are available in the drop down box selection.

Default: None

Avoid trouble: If a default JTA data source is not specified, ensure an appropriate JTA data source is specified in the <jta-data-source> or connection properties field in the <properties> element in the persistence unit.

Default non-JTA data source JNDI name

Specify the default non-JTA data source used by persistence units for the application server container.

Select the JNDI name for the data source from the drop down box. The data sources that are currently configured, visible to the application server, and are set to "non-transactional" are available in the drop down box selection.

Default: None

Avoid trouble: Some JPA entity features will require a non-JTA data source to be specified. An example of this is automatic entity identity generation. Ensure a non-JTA data source is configured to match your application needs. For information on configuring a non-JTA data source, see the topic on associating persistence units and data sources.