Configuring the Custom properties policy

When working with policy sets in the administrative console, you can customize policies to set generic properties that are not supported in other policy types. You must customize the Custom properties policy configuration because all properties within the policy are user-defined.

About this task

This administrative console page applies only to Java™ API for XML Web Services (JAX-WS) applications.

You can configure generic properties that are not supported in other policy types with the Custom properties policy. These additional properties are set in the binding. The Custom properties policy provides an alternative way to set a binding property instead of using the JAX-WS programming model to set the property on the BindingProvider object. The CustomProperties binding is only supported for service clients.

After you have created a new policy set with the Custom properties policy added, you must create a Custom properties binding and add at least one custom property to configure the binding. A Custom properties binding type can be added to a general client binding or an application specific client binding. You cannot create an empty Custom properties binding. You must define at least one name and value pair within the binding.

Mixed-version environment: In a mixed cell environment, the following limitations apply to attachments to policy sets containing CustomProperties policy:
  • You must not create attachments to policy sets containing CustomProperties policy for applications that are deployed on an application server that is prior to WebSphere® Application Server Version 8.0. The CustomProperties policy is only supported on WebSphere Application Server Version 8.0 and later.
  • An application that contains an attachment to a policy set containing CustomProperties policy must not be deployed on an application server that is prior to WebSphere Application Server Version 8.0.
  • If an application that is deployed in a cluster environment contains an attachment to a policy set containing CustomProperties policy, you must not add a member application server that is prior to WebSphere Application Server Version 8.0 to the cluster.

Procedure

  1. Create the Custom properties policy.
    1. Navigate to the Application policy sets or the System policy sets
      From the administrative console, click Services > Policy Sets > Application policy sets or Services > Policy Sets > System policy sets.
    2. Click the New... button.
    3. Enter a unique policy set name.
    4. Click the Add button and choose the Custom properties policy in the Policies table.
    5. Click the Apply button.
    6. Click the Save link.
    You cannot configure the Custom properties policy from this panel. You must configure your Custom properties with a Custom properties binding.
  2. Customize the Custom properties bindings.
    1. Navigate to the Custom properties bindings.
      From the administrative console, click Services > Policy Sets > General client policy set bindings > client_policy_set_binding_name.
    2. Click Add > Custom properties.

      The Custom properties (bindings) window displays options for adding Custom properties bindings.

    3. Specify the properties for each custom property you want to add.
      The following fields are required:
      Name
      Displays the name of the custom property.
      Value
      Displays the value of the custom property.

      The application specific bindings can be customized similarly, from the application policy set and bindings attachments panel.

Results

After you have customized the Custom properties policy, the associated policy set uses this policy to set generic properties that are not supported in other policy types.