WS-AtomicTransaction Configuration Utility (wsatConfig.exe)


The WS-AtomicTransaction Configuration Utility is used to configure basic WS-AtomicTransaction support settings.

wsatConfig [Options]  

This command line tool can be used to configure basic WS-AT settings in a local machine only. If you have to configure settings on both local and remote machines, you should use the MMC snap-in as described in Configuring WS-Atomic Transaction Support.

The command line tool can be found in the Windows SDK installation location, specifically,

%SystemRoot%\Microsoft.Net\Framework\v3.0\Windows Communication Foundation\wsatConfig.exe

If you are running Windows XP or Windows Server 2003, you must download an update before running WsatConfig.exe. For more information about this update, see Update for Commerce Server 2007 (KB912817) and Availability of Windows XP COM+ Hotfix Rollup Package 13.

The following table shows the options that can be used with WS-AtomicTransaction Configuration Utility (wsatConfig.exe).

System_CAPS_ICON_note.jpg Note

When you set an SSL certificate for a selected port, you overwrite the original SSL certificate associated with that port if one exists.

-accounts:<account,>Specifies a comma-separated list of accounts that can participate in WS-AtomicTransaction. The validity of these accounts is not checked.
-accountsCerts:<thumb>|"Issuer\SubjectName",>Specifies a comma-separated list of certificates that can participate in WS-AtomicTransaction. The certificates are indicated by thumbprint or by the Issuer\SubjectName pair. Use {EMPTY} for subject name if it is empty.
-endpointCert:<machine|<thumb>|"Issuer\SubjectName">Uses the machine certificate or another local endpoint certificate specified by thumbprint or Issuer\SubjectName pair. Uses {EMPTY} for the subject name if it is empty.
-maxTimeout:<sec>Specifies the maximum timeout in seconds. Valid values are from 0 to 3600.
-network:<enable|disable>Enables or disables the WS-AtomicTransaction network support.
-port:<portNum>Sets the HTTPS port for WS-AtomicTransaction.

If you have already enabled firewall before running this tool, the port is automatically registered in the exception list. If firewall is disabled before running this tool, nothing additional is configured regarding the firewall.

If you enable firewall after configuring WS-AT, you have to run this tool again and supply the port number using this parameter. If you disable firewall after configuring, WS-AT continues to work without additional input.
-timeout:<sec>Specifies the default timeout in seconds. Valid values are from 1 to 3600.
-traceActivity:<enable|disable>Enables or disables the tracing of activity events.
-traceLevel:<Off|Error|Critical|Warning|Information| Verbose|All>}Specifies the trace level.
-tracePII:<enable|disable>Enables or disables the tracing of personally identifiable information.
-traceProp:<enable|disable>Enables or disables the tracing of propagation events.
-restartRestarts MSDTC to activate changes immediately. If this is not specified, the changes take effect when MSDTC is restarted.
-showDisplays the current WS-AtomicTransaction protocol settings.
-virtualServer:<virtualServer>Specifies the DTC resource cluster name.

Using WS-AtomicTransaction
Configuring WS-Atomic Transaction Support