CustomProperties 原則和連結內容

使用 setBinding 指令的 -attributes 參數來指定 CustomProperties 原則集連結的其他配置資訊。 應用程式和系統原則集可使用 CustomProperties 原則和連結。

本產品支援使用 CustomProperties 原則和連結來設定其他內容類型不支援的一般內容。 其他內容是設定於連結中。 您只能更新原則中的現有內容,如 enabled 屬性。 CustomProperties 原則提供另一種方式來設定連結內容,取代使用 JAX-WS 程式設計模型在 BindingProvider 物件設定內容。 只有服務用戶端支援 CustomProperties 連結。

請利用 AdminTask 物件 PolicySetManagement 群組中的下列指令和參數來自訂您的原則集配置。
  • 利用 getPolicyType 和 getBinding 指令的 -attributes 參數來檢視原則和連結配置的內容。 如果要取得屬性,請將內容名稱傳給 getPolicyType 或 getBinding 指令。
  • 利用 setPolicyType 和 setBinding 指令的 -attributes 參數來新增、更新或移除原則和連結配置中的內容。 如果要新增或更新屬性,請指定內容名稱和值。 如果屬性存在,setPolicyType 和 setBinding 指令會更新值,如果屬性不存在,會新增屬性和值。 若要移除屬性,請將值指定為空字串 ("")。 -attributes 參數接受內容物件。
附註: 如果 -attributes 參數所提供的內容名稱或值無效,則 setPolicyType 和 setBinding 指令會因異常狀況而失敗。 無效的內容會在 SystemOut.log 檔中,記載為錯誤或警告。 不過,指令異常狀況不一定包含造成異常狀況之內容的詳細資訊。 當 setPolicyType 和 setBinding 指令失敗時,請檢查 SystemOut.log 檔中,是否有任何錯誤和警告訊息指出 -attributes 參數的輸入包含一或多個無效的內容。
附註: 這個主題參照一或多個應用程式伺服器日誌檔。 作為建議的替代方案,您可以將伺服器配置成使用「高效能可延伸記載 (HPEL)」日誌和追蹤基礎架構,而不使用分散式和 IBM® i 系統上的 SystemOut.logSystemErr.logtrace.logactivity.log 檔案。 您也可以將 HPEL 與原生 z/OS® 記載機能一起使用。 如果您使用 HPEL,則可以從伺服器設定檔 bin 目錄,利用 LogViewer 指令行工具來存取您所有的日誌和追蹤資訊。 如需使用 HPEL 的相關資訊,請參閱 使用 HPEL 的相關資訊 ,以進行應用程式疑難排解。
下列 setBinding 指令範例示範如何利用 CustomProperties 連結,來設定 WSADDRESSING_DESTINATION_EPR 端點參照連結內容的值:
AdminTask.setBinding('[-bindingLocation "" -bindingName generalCellWideBind1 -attachmentType client
 -policyType CustomProperties -attributes "[[WSADDRESSING_DESTINATION_EPR addressValue]]"]')
混合版本環境: 在混合 Cell 環境中,下列限制適用於包含 CustomProperties 原則之原則集的附件:
  • 對於部署在 WebSphere® Application Server 8.0版之前的應用程式伺服器上的應用程式,您不得建立包含 CustomProperties 原則之原則集的附件。 只有 WebSphere Application Server 8.0 版以及更新版本才支援 CustomProperties 原則。
  • 包含包含 CustomProperties 原則之原則集附件的應用程式不得部署在 WebSphere Application Server 8.0之前的應用程式伺服器上。
  • 如果部署在叢集環境中的應用程式包含連接至包含 CustomProperties 原則的原則集,則不得將 WebSphere Application Server 8.0 之前的成員應用程式伺服器新增至叢集。