Compensation service custom properties
You can specify additional settings for the compensation service through setting a custom property.
Complete the following steps to set a custom property for the compensation service.
- Start the administrative console.
- In the navigation pane, click .
- Click New.
- On the settings page, enter the property that you want to configure in the Name field and the value that you want to set it to in the Value field.
- Click Apply or OK.
- Click Save to save your changes to the master configuration.
- Restart the server.
You can use the custom properties page to define the following compensation service custom
property:
Suppressing the compensation service
Not all web servers are configured to handle SOAP messages containing CoordinationContext elements. You can use WebSphere® Application Server to configure a custom property for the compensation service which processes a predefined list of Enterprise Java Beans for which no CoordinationContext should be sent on web service requests.
When the compensation service is used, CoordinationContext elements are included in the outgoing
SOAP header. For
example:
<wscoor:CoordinationContext soapenv:mustUnderstand="1"
...
</wscoor:CoordinationContext>
If
such a SOAP message is received by a web server which is not configured to process
CoordinationContext elements, an exception message is produced. See the following
example:Header block local name 'CoordinationContext' is not defined.
You can construct a file containing a list of all Enterprise Java Beans which should not send the
CoordinationContext element in web service requests. This file must be in plain text format and must
contain one entry per line, in the following
format:
application_name#module#bean
application_name#module#bean
application_name#module#bean
Here
application_name
is the name of the application as known on the server;
module
is the name of the Enterprise Java Bean jar; and bean
is
the name of the Enterprise Java Bean.Note: This file must only contain entries for beans not
configured to use the compensation service. This custom property will not be effective for any beans
listed in the file which have compensation service metadata associated with them.
Name | Value |
---|---|
SUPPRESS_CSCOPE_ON_WS_CALLS | The fully qualified file name |