WebSphere Application Server Version 6.1 Feature Pack for Web Services
             Operating Systems: AIX, HP-UX, i5/OS, Linux, Solaris, Windows, z/OS

             Personalize the table of contents and search results
             New or updated topic for this feature pack

Attaching and binding a WS-ReliableMessaging policy set to a Web service application 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 the wsadmin tool to attach the policy set to your application, and (for managed qualities of service) to define bindings to a service integration bus and messaging engine.

Before you begin

You can attach a WS-ReliableMessaging policy set and define bindings using the wsadmin tool as described in this task, or you can attach and bind a WS-ReliableMessaging policy set using the administrative console.

This task assumes that you have already developed and installed the Web service application to which you want to attach a policy set.

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, or you have configured your own reliable messaging policy set, then you are ready to complete this task.

About this task

Use this task to complete the following broad actions:
  1. Attach a reliable messaging policy set (either a default policy set or one that you have created) to an aspect of your application (that is, application level or service level). Policy sets define the reliability level (quality of service) and other configuration options that you want to apply to your reliable messaging application.
  2. Define the bindings for each attachment to a policy set that specifies a managed quality of service. That is, choose the service integration bus and messaging engine to use to maintain the state for the managed persistent and managed non-persistent qualities of service.

To attach a WS-ReliableMessaging policy set and define bindings using the wsadmin tool, complete the following steps:

Procedure

  1. Attach a policy set to your reliable messaging application at either application level or service level.
    Use the createPolicySetAttachment command as described in Creating policy set attachments using the wsadmin tool. Set the -policySet parameter to the name of the reliable messaging policy set that you want to use. For example: "WSReliableMessaging persistent"
    Note:
    • You can attach one policy set at each level.
    • You can only apply a WS-ReliableMessaging policy at application level or service level.
    • If you apply reliable messaging at service level, then all services must use the same WS-ReliableMessaging policy and bindings values.
    • You can attach any policy set at operation level. For a policy set that includes the WS-ReliableMessaging policy, attachment at the operation level configures the other components of the policy set (for example WS-Security and WS-Addressing) but any WS-ReliableMessaging configuration at operation level is ignored.

    This command returns an attachment ID number. If your chosen policy set specifies a managed quality of service, make a note of this number. In the next step you use it to define the binding.

  2. If your chosen policy set specifies a managed quality of service, define bindings to a service integration bus and messaging engine.
    If the policy set instance specifies managed non-persistent or managed persistent quality of service, choose the service integration bus and messaging engine that is to manage the WS-ReliableMessaging state. Use the setBinding command as described in Creating policy set attachments using the wsadmin tool.
    Note:
    • Set the -policyType parameter to WSReliableMessaging.
    • To set the bus name and the messaging engine name, use the following syntax for the -attributes parameter:
       -attributes "[[busName ReliableMessagingBus] [messagingEngineName nodeName.serverName-busName]]"
    • When many applications use the same messaging engine, it can impact performance. Before you bind a reliable messaging application to a particular messaging engine, check how many other applications are already binding to that messaging engine and, if necessary, create a new messaging engine to bind to your application. In order to make the reliable message application environment more scalable in a cluster, increase the number of messaging engines associated with the cluster.
  3. Save your changes to the master configuration.
    To save your configuration changes, enter the following command:
    AdminConfig.save()



In this information ...


IBM Redbooks, demos, education, and more


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

This feature requires Internet access.

IBM Suggests
Task topic    

Terms of Use | Feedback

Last updated: Nov 25, 2008 2:35:59 AM CST
http://publib.boulder.ibm.com/infocenter/wasinfo/v6r1/index.jsp?topic=/com.ibm.websphere.wsfep.multiplatform.doc/info/ae/ae/twbs_wsrm_policy_attach_bind_cli.html