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.
newfeat 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. The CustomProperties policy is only supported on WebSphere Application Server
V8 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.
- 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 to the cluster.
mixv
Procedure
- Create
the Custom properties policy.
- Navigate
to the Application policy sets or the System
policy sets From the administrative console, click or .
-
Click the New... button.
- Enter a unique policy set name.
-
Click the Add button and choose
the Custom properties policy in the Policies
table.
- Click the Apply button.
- 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.
- Customize the Custom properties bindings.
- Navigate to the Custom properties bindings.
From
the administrative console, click .
- Click .
The Custom properties (bindings) window
displays options for adding Custom properties bindings.
- 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.