自訂搜尋器 SQL 動態增強功能內容

請利用這個頁面來修改自訂搜尋器 SQL 動態增強功能內容設定。

為了確保在所用後端資料儲存庫需要特殊 SQL 鎖定子句的 EJB 1.1 起始位置介面上定義的自訂搜尋器，能夠正確動態增強結構化查詢語言 (SQL)，我們提供了下列 Java 虛擬機器 (JVM) 和 Bean（模組）內容。如果後端儲存庫支援 SQL 子句，您可以利用這些內容來指示應該增強哪些自訂搜尋器。

[IBM i] [AIX Solaris HP-UX Linux Windows] 若為 i5/OS® 和分散式平台，如果要檢視這個管理主控台頁面，請按一下伺服器 > 伺服器類型 > WebSphere 應用程式伺服器 >server_name > Java 和程序管理 > 程序定義 > Java 虛擬機器 > 自訂內容

[z/OS] 若為 z/OS，如果要檢視這個管理主控台頁面，請按一下伺服器 > 伺服器類型 > WebSphere 應用程式伺服器 > server_name > 控制項（定義「控制項」中的內容）或服務者（定義「服務者」中的內容） > Java 和程序管理 > 程序定義 > Java 虛擬機器 > 自訂內容。

com.ibm.websphere.ejbcontainer.customfinder.honorAccessIntent

用來指示在執行時期，哪些 Enterprise Bean 應該啟用自訂搜尋器 SQL 動態增強功能。

這個內容在伺服器層次生效。任何定義了存取目的為 Update 之自訂搜尋器（字首為 find）的 EJB 1.1 起始位置介面，都是以指定隔離層次為基礎之自訂搜尋器 SQL 動態增強功能的候選項。如果後端資料儲存庫需要特殊 SQL 語意，就會套用它們。所用的特定 SQL 會隨著應用程式中的 Bean 的所選隔離層次和所用的後端資料庫而不同。如果設定為 all，安裝在儲存器的任何 Bean 中所定義的所有自訂搜尋器都會啟用自訂搜尋器 SQL 動態增強功能。如果設定為 J2EENAME[:J2EENAME]，其中 J2EENAME 是完整的套件或 Bean 名稱，只有安裝在儲存器且由指示的 Bean 名稱來表示的 Bean 中所定義的自訂搜尋器會啟用自訂搜尋器 SQL 動態增強功能。

參考資訊	值
資料類型	String
範圍	有效值是 all 或 J2EENAME[:J2EENAME]
預設值	增強行為不在作用中

註：部分應用程式可能會使用手動編寫且在 SELECT 作業中含有 SQL 鎖定子句或 ORDER BY 和 DISTINCT 關鍵字的自訂搜尋器。在這些實例中，如果執行時期嘗試 SQL 動態增強功能，有可能會在基礎後端資料儲存庫中引進形態異常的 SQL 陳述式。如果應用程式包含這些自訂搜尋器，當指定 JVM 內容 com.ibm.websphere.ejbcontainer.customfinder.honorAccessIntent 的值時，您必須非常小心。all 值會使在應用程式伺服器中所安裝的所有 Bean 中找到的、用 Update 存取目的來定義的每個自訂搜尋器方法發生自訂搜尋器 SQL 動態增強功能。

如果要防止發生這個情況，請勿將伺服器層的設定設成 all。相反地，請利用 Bean 方法層次內容 com.ibm.websphere.ejbcontainer.customfinder.honorAccessIntent.methodLevel，在個別 Bean 的基礎上，指示只有這些自訂搜尋器方法應該在執行時期執行自訂搜尋器 SQL 動態增強功能。

com.ibm.websphere.ejbcontainer.customfinder.honorAccessIntent.methodLevel

用來指示在特定 Bean 的方法層次上啟用自訂搜尋器 SQL 動態增強功能。

當將這個內容設成一或多個自訂搜尋器方法組成的清單來定義 Bean 時，起始位置介面中所定義的任何含相符方法名稱和參數簽章的自訂搜尋器（字首為 find），在執行時期都會套用 SQL 鎖定語意。只有在自訂搜尋器指定了 Update 存取目的，且後端資料儲存庫支援 SQL 子句時，才會發生這個情況。所用的特定 SQL 會隨著應用程式的所選隔離層次和所用的後端資料儲存庫而不同。

參考資訊	值
資料類型	String
範圍	有效值是這個形式的字串：method1(parm1,parm2,..parmn):method2(parm1,parm2,..parmn):methodn(...)

com.ibm.websphere.persistence.bean.managed.custom.finder.access.intent

供 WebSphere Application Server for z/OS® 4.x 版使用者用來指示安裝在 WebSphere Application Server for z/OS 產品中的應用程式不應套用 SQL 增強功能。

WebSphere Application Server for z/OS 4.x 版產品的預設行為是執行動態 SQL 增強功能。如果 z/OS 使用者選擇不參與 4.x 版產品之自訂搜尋器的動態 SQL 增強功能，這個屬性的作用是在 Bean 和伺服器層次建立這項指示。

在 Bean 層次上，這個屬性名稱和 true 值所組成的名稱/值配對會停用在給定 Bean 起始位置介面中所定義的任何自訂搜尋器的 SQL 增強功能。

在伺服器層次上，WebSphere Application Server for z/OS 伺服器內容檔中含 true 值的項目，會停用在給定伺服器中所安裝的所有 Bean 的 SQL 增強功能。

產品的執行時期仍支援 Bean 層次的這個自訂搜尋器增強屬性。舊版的預設行為是不動態增強自訂搜尋器 SQL，這個情況使它作為伺服器層面指示器的用途已遭到淘汰。

註：如果您的 WebSphere Application Server for z/OS 安裝架構必須依賴所有安裝的應用程式中之所有自訂搜尋器的自動動態增強功能，您應該將 com.ibm.websphere.ejbcontainer.customfinder.honorAccessIntent 指示器設定為 all。如果應用程式中的 Bean 將 com.ibm.websphere.persistence.bean.managed.custom.finder.access.intent 指示器設在其 env-var 設定中，如上述說明，倘若啟用了產品的動態 SQL 增強功能，就會繼續使用這個指示器。

參考資訊	值
資料類型	String
範圍	有效值是 true 和 false

優先順序相關注意事項：

com.ibm.websphere.ejbcontainer.customfinder.honorAccessIntent.methodLevel 屬性會置換任何伺服器層或 Bean 層次的屬性設定
在 com.ibm.websphere.ejbcontainer.customfinder.honorAccessIntent 指示器中，利用 J2EE 名稱來列出的任何 Bean，都會使定義給這個 Bean 的自訂搜尋器發生動態增強，即使相關伺服器的預設行為在作用中也一樣。
如果啟用了伺服器層設定或 Bean 設定，且沒有指定方法層次設定，com.ibm.websphere.persistence.bean.managed.custom.finder.access.intent 屬性會使特定 Bean 停用這項特性。

檔名： udat_sqllock.html