所有策略的策略配置属性
可以通过执行 setPolicyType 和 setBinding 命令并附带 attributes 参数来为策略集中的每种服务质量 (QoS) 指定各种属性。可以对应用程序和系统策略集中的每种 QoS 使用本主题中的属性。
请在 AdminTask 对象的 PolicySetManagement 组中使用下列命令和参数来定制策略集配置。
- 将 -attributes 参数用于 getPolicyType 和 getBinding 命令以查看策略和绑定配置的属性。要获取属性,请将属性名传递至 getPolicyType 或 getBinding 命令。
- 将 -attributes 参数用于 setPolicyType 和 setBinding 命令以在策略和绑定配置中添加、更新或除去属性。要添加或属性更新,请指定属性名和属性值。如果该属性存在,那么 setPolicyType 和 setBinding 命令更新该值;如果该属性不存在,那么会添加该属性及值。要除去属性,请指定属性值为空字符串 ("")。-attributes 参数接受属性对象。
注: 如果使用 -attributes 参数提供的属性名或值无效,那么 setPolicyType 和 setBinding 命令将失败并产生异常。无效的属性作为错误或警告记录在 SystemOut.log 文件中。但是,命令异常可能不包含有关导致该异常的属性的详细信息。当 setPolicyType 和 setBinding 命令失败时,请检查 SystemOut.log 文件以找到任何指示 -attributes 参数的输入包含一个或多个无效属性的错误和警告消息。
注: 本主题引用了一个或多个应用程序服务器日志文件。作为另一种建议采用的方法,您可以在分布式系统和 IBM® i 系统上配置服务器以使用高性能可扩展日志记录 (HPEL) 记录和跟踪基础结构,而不使用 SystemOut.log、SystemErr.log、trace.log 和 activity.log 文件。您还可以将 HPEL 与本机 z/OS® 日志记录设施结合使用。如果要使用 HPEL,那么可从服务器概要文件
bin 目录使用 LogViewer 命令行工具来访问所有日志和跟踪信息。有关使用
HPEL 的更多信息,请参阅有关使用 HPEL 对应用程序进行故障诊断的信息。
在使用此主题中的命令之前,请验证是否在使用 wsadmin 工具的最新版本。将属性对象作为 attributes 或 bindingLocation 参数的值来接受的策略集管理命令不受 wsadmin 工具的先前版本支持。例如,这些命令不在 V6.1.0.x 节点上运行。
要为所有 QoS 策略配置的属性
使用以下属性列表并通过使用 Jython 脚本语言和 wsadmin 工具来配置所有 QoS 策略中的属性:
- 已启用
- 指定是启用还是禁用了策略类型。以下示例提供了输入属性参数时使用的格式:
-attributes "[[enabled true]]"
- provides
- 提供对配置的描述。以下示例提供了输入属性参数时使用的格式:
-attributes "[[provides [Messaging Security]]]"
以下示例使用 setPolicyType 命令来设置定制策略集
myCustomSecurityPS(该策略集包含 ReliableMessaging 策略)的 enabled 和 provides 属性:
AdminTask.setPolicyType('[-policySet myCustomSecurityPS -policyType
WSReliableMessaging -attributes [[enabled true][provides
[Messaging security]]]]')