WAS v8.5 > Administer applications and their environment > Administer web services - Transaction support (WS-Transaction) > Use WS-Transaction policy to coordinate transactions or business activities for web services

Configure a WS-Transaction policy set using wsadmin.sh

We can configure the way that a Java API for XML Web Services (JAX-WS) client or web service handles Web Services Atomic Transaction (WS-AT) or Web Services Business Activity (WS-BA) context by configuring the Web Services Transaction (WS-Transaction) policy type. We can specify the client or service must use context, can use context if it is available, or must not use context. Use command scripts to configure a policy set for web services transactions.

We can configure a WS-Transaction policy set using wsadmin.sh as described in this task, or we can configure a WS-Transaction policy set using the dmgr console.

WS-Transaction policy set support only exists at the application and service level. Although the dmgr console allows for the attachment of WS-Transaction policies/bindings at the endpoint and/or operation levels, they do not actually take affect.

  1. Start the wsadmin scripting client if it is not already running.

  2. Use the createPolicySet command to create a new policy set, or the copyPolicySet command to copy and rename an existing policy set. We can copy an existing user-defined policy set, or one of the WS-Transaction default policy sets (WSTransaction or SSL WSTransaction).
  3. Check that your policy set includes the WS-Transaction policy type. If necessary, add the WS-Transaction policy type. For example: 
    AdminTask.importPolicySet('[-defaultPolicySet WSTransaction]') 
AdminTask.addPolicyType('[-policySet policy_set_name 
-policyType WSTransaction -enabled true]')

  4. Use the setPolicyType command to configure the WS-Transaction policy type attributes. The WS-Transaction policy type has the following attributes:

    • ATAssertion
    • BAAtomicOutcomeAssertion

    Each attribute can have the value supports, mandatory, or never. For detailed information about these configurable attributes, see the topic about WS-Transaction policy settings. For example: 

    AdminTask.setPolicyType('[-policySet policy_set_name 
-policyType WSTransaction 
-attributes "[ [BAAtomicOutcomeAssertion mandatory] [ATAssertion supports] ]"] 
-replace')

  5. Save your changes to the master configuration. For example, enter the following command:

You are now ready to associate the policy set with the JAX-WS client, or with the JAX-WS web service, endpoint, or operation.


Related concepts:

WSTransaction default policy sets


Related


Configure a JAX-WS client for WS-Transaction context
Configure a JAX-WS web service for WS-Transaction context
Configure application and system policy sets for web services using wsadmin.sh
Create policy sets using wsadmin.sh
Start the wsadmin scripting client using wsadmin.sh


Reference:

WS-Transaction policy settings
PolicySetManagement command group for AdminTask


+

Search Tips   |   Advanced Search