New EJB CMP component properties

Table 4-1 lists new component properties that you can set on the Advanced tab in the EAServer Manager Component Properties dialog box for EJB entity beans that use Container Managed Persistence (CMP). Actual property names are prefixed with com.sybase.jaguar.component. These properties were added for the 4.1.3 and 4.2.2 releases, as indicated in the table.

Table 4-1: New component properties

Property

Description

com.sybase.jaguar.component.lwc (New in 4.1.3)

Enables the EJB lightweight container.

com.sybase.jaguar.component.cmp_iso_level

(New in 4.1.3)

Specifies the effective transaction isolation level for EJB CMP entity beans.

com.sybase.jaguar.component.defer

(New in 4.1.3)

When using one of the Sybase CMP wrapper drivers, specifies which SQL commands may be deferred to the end of the transaction.

com.sybase.jaguar.component.selectForUpdate

(New in 4.1.3)

Similar to the Select With Lock (selectWithLock) Persistence setting, but requests an exclusive database lock be obtained at select time to avoid deadlocks during lock promotion. If this is used, also consider configuring the database table for row-level locking.

com.sybase.jaguar.component.tlc.sort

(New in 4.1.3)

Specifies that transaction local cache entries for this component should be sorted before ejbStore is called. Setting this property to true helps to avoid deadlock when separate transactions concurrently update multiple instances of the same component.

You cannot enable this unless the primary key class implements the java.lang.Comparable interface. Most java.lang utility classes implement this interface, such as String, Integer and so forth.

com.sybase.jaguar.component.softLock

(New in 4.2.2)

See “Soft locking”.

com.sybase.jaguar.component.softLock.timeout

(New in 4.2.2)

See “Soft locking”.

com.sybase.jaguar.component.touchColumn

(New in 4.2.2)

Used when the selectForUpdate property is true. For databases such as Sybase Adaptive Server Enterprise that do not support select for update locking syntax, EAServer locks rows by issuing a no-change update statement. This property specifies which column to update.

com.sybase.jaguar.component.ts.triggers

(New in 4.1.3)

Specifies that the storage component (CtsComponents/JdbcStorage) should automatically create database triggers to enforce the required timestamp semantics when using table-level timestamps.

com.sybase.jaguar.component.tx_retry

(New in 4.1.3)

Enables automatic transaction retry for EJB CMP entity beans that use optimistic concurrency control (OCC).

NoteEnabling the lightweight container Beginning in EAServer 4.2.2, you must explicitly enable the lightweight EJB container (LWC) for each component that uses it. See “Lightweight EJB container” for more information.