Custom finder SQL dynamic enhancement
To ensure data integrity for applications using custom finders defined on EJB version 1.1 home interfaces, WebSphere Application Server v6.x uses custom finder Structured Query Language (SQL) dynamic enhancement to maintain correct SQL locking semantics.
WAS uses SQL clauses applied to the custom finder SQL statements for those custom finders defined with the Update attribute and certain method-level isolation level settings. These dynamic enhancements are applied only if the backend data store supports these clauses.
This support takes affect at run time when the run time attempts to execute container-managed persistence (CMP) persistence operations associated with the custom finders. To ensure that the SQL dynamic enhancements occur correctly for custom finders defined on an EJB version 1.1 home interface accessing a backend data store that requires the special SQL locking clauses, WAS provides new Java Virtual Machine (JVM) and bean (module) properties. These properties allow us to indicate which custom finders should be enhanced, provided the backend store supports the SQL clauses. For more information about these properties, Custom finder SQL dynamic enhancement properties.
There are several important items to consider when using this functionality:
- This support only applies to EJB version 1.1 CMP Custom Finder methods
- Option A CMP beans and CMP beans involved in an inheritance relationship are not supported
- Applications using this capability in WAS for z/OS Version 4.x continue to function, but we must address some compatibility issues:
- The default behavior of WAS v5.x and later is the opposite of the Version 4.x product, that is, the default for 5.x and later is not to enhance custom finder SQL statements unless directed to by specific settings. If our WAS for z/OS installation relies on the automatic dynamic enhancement of all custom finders in all applications installed, set the com.ibm.websphere.ejbcontainer.customfinder.honorAccessIntent indicator to all.
- If an application contains a bean which has the com.ibm.websphere.persistence.bean.managed.custom.finder.access.intent indicator set into its env-var settings, that indicator continues to be used, provided the dynamic SQL enhancement features of the product at v5.x and later are enabled. See topic Custom finder SQL dynamic enhancement properties.
Subtopics
- Custom finder SQL dynamic enhancement properties
Modify custom finder SQL dynamic enhancement properties settings.- Custom finder SQL dynamic enhancement properties
Modify custom finder SQL dynamic enhancement properties settings.
Establishing custom finder SQL dynamic enhancement server-wide Establishing custom finder SQL dynamic enhancement on a set of beans Establishing custom finder SQL dynamic enhancement for specific custom finders Disable custom finder SQL dynamic enhancement for custom finders on a specific bean