Edit

Share via

COM+ CRM Registry Settings

  • Article

Several registry settings are available to modify CRM behavior to assist with troubleshooting and development. All of these registry settings, which are listed and described in the following table, are optional; none are required for normal operation of the CRM.

All CRM registry settings are under HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\COM3\CRM. Create the CRM key under the COM3 key if it is not already there.

CRM registry settings Description
VTRACE1
 REG_DWORD value. Setting this value to anything other than zero enables debug trace messages on warnings or errors. These messages can be seen in the debugger output window. This value should be set for development only and not during normal deployment. This value is read when any CRM server application starts up.
IgnoreCompensatorErrors
 REG_DWORD value. Setting this value to anything other than zero allows the CRM infrastructure to ignore all errors returned from CRM Compensators. If recovery is failing due to an error from a CRM Compensator, setting this value allows recovery to be completed. This value is read when any CRM server application starts up.
CheckpointIntervalInSec
 REG_DWORD value. This is the checkpoint interval in seconds. The default checkpoint interval is 30 seconds. Checkpoints are used to reclaim space from the CRM log file. Increasing the checkpoint interval may increase performance, but at the expense of increased recovery time and a larger CRM log file. This value is read when any CRM server application starts up.
InitialLogFileSizeInKB
 REG_DWORD value. This is the initial CRM log file size in kilobytes. The default CRM log file size is 1024 KB (1 MB). The CRM log file automatically expands to meet the transaction load imposed upon it, but if heavy loads are anticipated, it might be necessary to increase this value. This value is read when any CRM enabled COM+ server application starts up, but if the CRM log file already exists for a CRM server application, this value is ignored for that server application.
RecoveryTraceEnabled
 REG_DWORD value. Setting this value to anything other than zero enables a recovery trace. The recovery trace is a text file that has the same name as the CRM log file and the following additional extension: .recoverytrace.txt.
This file is located in the same directory as the CRM log file. The recovery trace provides a trace of CRM activity during recovery, which can be used for problem diagnosis. This value is read when any CRM server application starts up. However, a unique recovery trace file is produced for each CRM server application.

COM+ Compensating Resource Manager Concepts