Configuring a WS-ReliableMessaging policy set using the wsadmin tool

To configure a Web service application to use WS-ReliableMessaging, you attach a policy set that contains a WS-ReliableMessaging policy type. This policy type offers a range of qualities of service: managed persistent, managed non-persistent, or unmanaged non-persistent. Use command scripts to configure a policy set for reliable messaging.

Before you begin

You can configure a reliable messaging policy set using the wsadmin tool as described in this task, or you can configure a reliable messaging policy set using the administrative console.

The following default policy sets work with WS-ReliableMessaging applications:
  • LTPA RAMP default
  • RAMP default
  • Username RAMP default
  • WSReliableMessaging 1_0
  • WSReliableMessaging default
  • WSReliableMessaging persistent
For more information, see WS-ReliableMessaging default policy sets.

If you can use any of these default policy sets without needing to modify their configuration, you need not complete this task. You are ready to attach your application to the default policy set and define the bindings that you want to use.

About this task

To configure a reliable messaging policy set using the wsadmin tool, complete the following steps:

Procedure

  1. Create a policy set. Use the createPolicySet command to create a new policy set, or the copyPolicySet command to copy and rename an existing policy set - either one that you have previously created, or one of the two WS-ReliableMessaging default policy sets. For more information, see Creating and copying policy sets using the wsadmin tool.
  2. If the policy set does not include both the policy types WSReliableMessaging and WSAddressing, add these policy types using the addPolicyType command as described in Creating and copying policy sets using the wsadmin tool. For example:
    AdminTask.addPolicyType('[-policySet PolicySet1 -policyType WSReliableMessaging]')
    AdminTask.addPolicyType('[-policySet PolicySet1 -policyType WSAddressing]')
    These policy types contain the configuration options that support WS-ReliableMessaging. WS-Addressing provides the asynchronous request and reply capabilities for WS-ReliableMessaging.
    Note: If you want to use secure conversation and reliable messaging policies in the same policy set, the secure conversation bindings must be configured to require that the reliable messaging headers are signed. The RAMP policy set is specifically designed and configured to use secure conversation and reliable messaging policies in the same policy set. If you use a copy of the RAMP policy set, no further configuration of the secure conversation bindings is required. Otherwise, see Configuring WS-SecureConversation to work with WS-ReliableMessaging.
  3. Configure the WS-ReliableMessaging policy type attributes. For the WS-ReliableMessaging policy you can configure the version of the WS-ReliableMessaging standard that you want to use, the option to use the WS-MakeConnection protocol for synchronous two-way message exchange, the order in which messages are delivered, and the required quality of service (the reliability level) for message delivery. For detailed information about these configurable attributes, see WS-ReliableMessaging settings.
    Use the setPolicyType command to configure these attributes. For example:
    AdminTask.setPolicyType('-policySet PolicySet1 -policyType WSReliableMessaging -attributes "[[useMakeConnection false][inOrderDelivery false][specLevel 1.0][enabled true][qualityOfService managedPersistent][type WSReliableMessaging]]" -replace'
  4. Save your changes to the master configuration.
    To save your configuration changes, enter the following command:
    AdminConfig.save()

What to do next

You are now ready to attach your application to the policy set and define the bindings that you want to use.



In this information ...


IBM Redbooks, demos, education, and more

(Index)

Use IBM Suggests to retrieve related content from ibm.com and beyond, identified for your convenience.

This feature requires Internet access.

Task topic Task topic    

Terms and conditions for information centers | Feedback

Last updatedLast updated: Aug 31, 2013 1:23:07 AM CDT
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=pix&product=was-nd-dist&topic=twbs_wsrm_policy_config_cli
File name: twbs_wsrm_policy_config_cli.html