Policy configuration properties for all policies
Use the attributes parameter with the setPolicyType and setBinding commands to specify various properties for each quality of service (QoS) within a policy set. Use the properties in this topic with each QoS within application and system policy sets.
Use the following commands in the PolicySetManagement group of the AdminTask object to customize your policy set configuration.
- Use the -attributes parameter for the getPolicyType and getBinding commands to view the properties for our policy and binding configuration. To get an attribute, pass the property name to the getPolicyType or getBinding command.
- Use the -attributes parameter for the setPolicyType and setBinding commands to add, update, or remove properties from your policy and binding configurations. To add or update an attribute, specify the property name and value. The setPolicyType and setBinding commands update the value if the attribute exists, or adds the attribute and value if the attribute does not exist. To remove an attribute, specify the value as an empty string (""). The -attributes parameter accepts a properties object.
If a property name or value supplied with the -attributes parameter is not valid, then the setPolicyType and setBinding commands fail with an exception. The property that is not valid is logged as an error or warning in the SystemOut.log file. However, the command exception might not contain the detailed information for the property that caused the exception. When the setPolicyType and setBinding commands fail, examine the SystemOut.log file for any error and warning messages that indicate that the input for the -attributes parameter contains one or multiple properties that are not valid.
IBM recommends using the High Performance Extensible Logging (HPEL) log and trace infrastructure . We view HPEL log and trace information using the logViewer .
Before using the commands in this topic, verify that we are using the most recent version of the wsadmin tool. The policy set management commands that accept a properties object as the value for the attributes or bindingLocation parameters are not supported on previous versions of the wsadmin tool. For example, the commands do not run on a v6.1.0.x node.
Attributes to configure for all QoS policies
Use the following list of attributes to configure attributes across all QoS policies using the Jython scripting language and the wsadmin tool:
- enabled
Specifies whether the policy type is enabled or disabled. The following example provides the format to enter the attributes parameter:
-attributes "[[enabled true]]"
- provides
Provides a description for our configuration. The following example provides the format to enter the attributes parameter:
-attributes "[[provides [Messaging Security]]]"The following example uses the setPolicyType command to set the enabled and provides properties for the myCustomSecurityPS custom policy set, which contains a ReliableMessaging policy:
AdminTask.setPolicyType('[-policySet myCustomSecurityPS -policyType WSReliableMessaging -attributes [[enabled true][provides [Messaging security]]]]')
Related:
Web services policies Configure application and system policy sets for web services Configure a WS-Transaction policy set by Use High Performance Extensible Logging to troubleshoot applications PolicySetManagement WSSecurity policy and binding properties WSAddressing policy and binding properties SSLTransport policy and binding properties HTTPTransport policy and binding properties WSReliableMessaging policy and binding properties