Parameters You Can Use with the Crash Log

The following describes the parameter that you can use with the crash log. You can use the following parameters:

  • any_in_trace

  • all_in_trace

  • ex_white_list

  • ex_black_list

To separate values in these parameters, you can use the following symbols:

  • , (comma)

  • ; (semicolon)

  • | (vertical bar)

  • / (forward slash)

  • \t (backward slash with a t)

  • (single space)

Parameter Description

enable

You can use one of the following values:

  • 1. Crash log is enabled.

  • 0. Crash log is disabled

count

An integer that specifies the maximum of old log files that Siebel CRM Desktop preserves in the output logging directory.

on_top

A string that specifies the filtering condition for the crash log. Siebel CRM Desktop applies this filtering only if the item you specify resides at the start of the stack trace when the failure occurs. For example, you can use the following value:

CRMDesktop3D.dll

If you do not specify a value, then Siebel CRM Desktop ignores this parameter.

on_top_op

You can use one of the following values:

  • 0. Combine the item that the on_top parameter filters with the item that the any_in_trace parameter specifies or with the item that the all_in_trace parameter specifies. Use an OR logic operation.

  • 1. Combine the item that the on_top parameter filters with the item that the any_in_trace parameter specifies and with the item that the all_in_trace parameter specifies. Use an AND logic operation.

  • 2. Combine the item that the on_top parameter does not filter with the item that the any_in_trace parameter specifies or with the item that the all_in_trace parameter specifies. Use an OR logic operation.

  • 3. Combine the item that the on_top parameter does not filter with the item that the any_in_trace parameter specifies and with the item that the all_in_trace parameter specifies. Use an AND logic operation.

any_in_trace

A string that specifies a list of items. If the stack trace includes an item you specify, then Siebel CRM Desktop saves a crash log for this item. For example, you can use the following value:

Ntdll.dll,Kernel32.dll

In this example, if the stack trace includes an entry for Ntdll.dll or Kernel32.dll, then Siebel CRM Desktop saves a crash log for this item.

all_in_trace

A string that specifies a list of items. If the stack trace includes all the items you specify, then Siebel CRM Desktop saves a crash log for these items. For example, you can use the following value:

Ntdll.dll,Kernel32.dll

In this example, if the stack trace includes an entry for Ntdll.dll and an entry for Kernel32.dll, then Siebel CRM Desktop saves a crash log for these items.

delay_ms

An integer that specifies a delay in milliseconds. If the time that elapses after a previous exception exceeds the value you specify, then Siebel CRM Desktop saves a crash log.

The default value is 0. This default makes sure that Siebel CRM Desktop always saves a crash log.

ex_white_list

A string that specifies a list of C++ exception names. If an exception occurs for an exception name you specify, then Siebel CRM Desktop creates a minilog for this exception.

ex_black_list

A string that specifies a list of C++ exception names that Siebel CRM Desktop uses to not create a minilog. If the white_list parameter is empty, then Siebel CRM Desktop creates a log for all exceptions except the exceptions that the black_list parameter lists.

sigabrt

SIGABRT is a signal that Siebel CRM Desktop sends to a process to tell it to end. You can use one of the following values:

  • 1. Intercept the SIGABRT signal to save a crash log. You must use this parameter only for troubleshooting. Do not enable it permanently.

  • 0. Do not intercept the SIGABRT signal to save a crash log.

minidump_type

An integer that specifies the minilog type. The default value is 1 (MiniDumpNormal|MiniDumpWithDataSegs).

Use this parameter with caution because other values could increase log size significantly. For more information, see documentation about the DumpType parameter of the MiniDumpWriteDump function at the Microsoft MSDN website.