供 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 Home 介面中所定義的任何自訂搜尋器的 SQL 增強功能。
在伺服器層次上,WebSphere Application Server for z/OS 伺服器內容檔中含 true 值的項目,會停用在給定伺服器中所安裝的所有 Bean 的 SQL 增強功能。
5.x 版產品的執行時期仍支援 Bean 層次的這個自訂搜尋器增強屬性。5.x 版不動態增強自訂搜尋器 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 設定中,在依照上述說明啟用了 5.x 版產品的動態 SQL 增強功能特性的情況下,可以繼續使用這個指示器。
資料類型 |
字串 |
範圍 |
有效值是 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 停用這項特性。