Previous Topic: FsiDrvNext Topic: lang


Instrumentation

CA ControlMinder maintains cainstrm.dll behavior settings (which apply to all loaded plug-ins) it uses under the following key:

HKEY_LOCAL_MACHINE\SOFTWARE\ComputerAssociates\AccessControl\Instrumentation

The Instrumentation registry key contains the following registry entries:

Active

Specifies whether cainstrm.dll is active (1).

If you specify 0, cainstrm.dll loads but does not process any plug-ins.

Type: REG_DWORD

Default: 1

ApplyOnProcess

Defines the list of processes to which instrumentation applies.

You can define the name of the service or the full pathname. Names are not case sensitive. For example, "services.exe", "\system32\services.exe", "c:\windows\system32\services.exe".

Type: REG_MULTI_SZ

By default, this token is not set (instrumentation applies to any process).

ExcludeProcess

Defines the list of processes to which instrumentation does not apply.

Note: This entry is valid only if ApplyOnProcess is not set.

Type: REG_MULTI_SZ

By default, this token is not set.

RunTimeInstrumentationDisabled

Specifies the CA ControlMinder instrumentation policy at run time.

Type: REG_DWORD

Limits: 0, runtime instrumentation enabled; 1, runtime instrumentation disabled.

Default: 0

RunTimeInstrumentationIncludeList

Defines a list of processes to apply the runtime instrumentation to.

Type: REG_MULTI_SZ

Default: empty

TraceDbgEnable

Specifies whether to trace status flag for the cainstrm module, that is, enables tracing into DbgView or Kernel Debugger.

Type: RED_DWORD

Limits: 0, false; 1, true.

Default: 0

TraceFileIsCyclic

Specifies the type of the trace file.

Type: REG_DWORD

Limits: 0, trace file is not cyclic; 1, trace file is cyclic.

Default: 0

TraceFileSizeLimit

Defines the maximum size of the trace file in bytes. A value of 0 means no maximum size limit is imposed on the trace file.

Type: REG_DWORD

Default: 0

TraceFilteringMask

Defines the filtering mask for each plugin. The supported values for this registry value change depending on the status of the software component for which you define the registry value. Two values are predefined: 0, all information is filtered (display no information); 0x0ffffffff, no information is filtered (display all information).

Type: REG_DWORD

Default: 0

Note: We recommend that you do not change the value of this registry entry yourself. For assistance, contact CA Support at http://ca.com/support.

TraceFolderPath

Defines the full pathname to the trace file.

Type: REG_SZ

Default: Blank

TraceOutputMask

Defines the filtering mask for the trace output channels - debug stream, file, or ETW. You can specify that the trace outputs to file, to DbgView debug channel, or to WinDbg debug channel. A value of 0 disables any output.

Type: REG_DWORD

Default: 0

Note: We recommend that you do not change the value of this registry entry yourself. For assistance, contact CA Support at http://ca.com/support.

UnloadIfNoPlugins

Specifies whether cainstrm.dll is automatically unloaded (1) when no plug-ins are assigned for a current process.

If you specify 0, cainstrm.dll loads but does not process plug-ins.

Type: REG_DWORD

Default: 1