Set a WS-Transaction policy set using wsadmin

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 that 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.

Configure a WS-Transaction policy set using the wsadmin tool as described in this task, or we can configure a WS-Transaction policy set using the admin console.

 

1. Start wsadmin 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 the 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 WS-Transaction policy settings.

   For example:

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

5. Save the changes to the master configuration.

   For example...

   AdminConfig.save()

 

Next steps

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

WSTransaction default policy sets

 

Related tasks

Set a JAX-WS client for WS-Transaction context
Set a JAX-WS Web service for WS-Transaction context
Create policy sets using wsadmin
Start wsadmin

 

Related

WS-Transaction policy settings

 

Related information

Set application and system policy sets for Web services using scripting