Trace Bit
Trace bits and least significant Byte
The LogMask and the CollectedLogMask settings are controlled with trace bits. The following graphic illustrates this:
The trace level of the log mask is set by the least significant byte (LSB) of the TraceMask-setting. Change this single digit to set a new trace level.
| Least Significant Byte (LSB) | Meaning |
|---|---|
| xxxxxxx0 | Logging is turned off |
| xxxxxxx1 | Only fatal errors are logged |
| xxxxxxx2 | Only fatal errors and errors are logged |
| xxxxxxx3 | Only fatal errors, errors and warnings are logged |
| xxxxxxx4 | Only fatal errors, errors, warnings and informational messages are logged |
| xxxxxxx5 - xxxxxxxf | Fatal errors, errors, warnings, informational and debug messages are logged |
The other digits of the TraceMask-parameters define which trace message types are logged when the trace level in the last digit is set to debug. The following list shows all defined trace bits of the trace mask. They are only relevant when the trace level of the log mask is set to log debug messages. Conversely, setting the trace level to log debug messages requires that also one or several of the trace bits are set. Multiple messages can be combined via bitwise OR.
Note that the COLLECTED bit (0x80000000) must be set to
activate the collected trace messages. If this bit is not set, the TraceMaskCollectMsg-settings have no effect and no
collected trace messages are logged.
b+s ConnectMCAL
| Trace Flags | Trace Bit | Trace Flags | Trace Bit | Trace Flags | Trace Bit | ||
|---|---|---|---|---|---|---|---|
| COMMUNICATION | 0x00000010 | TRANSACTION | 0x00002000 | CREATE | 0x01000000 | ||
| TPI | 0x00000020 | SCHEDULER | 0x00004000 | DELETE | 0x02000000 | ||
| ICM | 0x00000040 | CONFIG | 0x00008000 | BEGIN_METHOD | 0x04000000 | ||
| AGENT | 0x00000080 | MESSAGE_NAME | 0x00010000 | END_METHOD | 0x08000000 | ||
| CALL | 0x00000100 | MESSAGE_DETAIL | 0x00020000 | COLLECTED | 0x80000000 | ||
| HEARTBEAT | 0x00040000 | ||||||
| PERFORMANCE_DATA | 0x00080000 |
b+s Media Manager
| Trace Flags | Trace Bit | Trace Flags | Trace Bit | Trace Flags | Trace Bit | ||
|---|---|---|---|---|---|---|---|
| MCIL | 0x00000020 | SCHEDULER | 0x00004000 | MANAGER | 0x00200000 | ||
| ARM | 0x00000040 | CONFIG | 0x00008000 | CREATE | 0x01000000 | ||
| MRI | 0x00000080 | MESSAGE_NAME | 0x00010000 | DELETE | 0x02000000 | ||
| Agent | 0x00000100 | MESSAGE_DETAIL | 0x00020000 | BEGIN_METHOD | 0x04000000 | ||
| AGT | 0x00000200 | HEARTBEAT | 0x00040000 | END_METHOD | 0x08000000 | ||
| AGT_DETAIL | 0x00000400 | PERFORMANCE_DATA | 0x00080000 |
b+s Data Store
| Trace Flags | Trace Bit | Trace Flags | Trace Bit | Trace Flags | Trace Bit | ||
|---|---|---|---|---|---|---|---|
| COMMUNICATION | 0x00000010 | TRANSACTION | 0x00002000 | CREATE | 0x01000000 | ||
| SERVICE | 0x00000800 | SCHEDULER | 0x00004000 | DELETE | 0x02000000 | ||
| CONFIG | 0x00008000 | BEGIN_METHOD | 0x04000000 | ||||
| MESSAGE_NAME | 0x00010000 | END_METHOD | 0x08000000 | ||||
| MESSAGE_DETAIL | 0x00020000 | COLLECTED | 0x80000000 | ||||
| HEARTBEAT | 0x00040000 | ||||||
| PERFORMANCE_DATA | 0x00080000 |
b+s Chat Connector
| Trace Flags | Trace Bit | Trace Flags | Trace Bit | Trace Flags | Trace Bit | ||
|---|---|---|---|---|---|---|---|
| COMMUNICATION | 0x00000010 | CHATGATEMCO | 0x00001000 | COLLECTED | 0x80000000 | ||
| SERVICE | 0x00000020 | JABBERGATEMCO | 0x00002000 | ||||
| CHATCONNECTOR | 0x00000040 | JABBERGATE | 0x00004000 | ||||
| MMGATEMCO | 0x00000080 | ||||||
| MULTISESSIONUSERMAPPING | 0x00000100 | ||||||
| AGENTTASK | 0x00000200 | ||||||
| MCILGATE | 0x00000400 | ||||||
| MCILGATEMCO | 0x00000800 |
b+s Routing Adapter
| Trace Flags | Trace Bit | Trace Flags | Trace Bit | Trace Flags | Trace Bit | ||
|---|---|---|---|---|---|---|---|
| COMMUNICATION | 0x00000010 | SIEBELROUTINGDETAILS | 0x00001000 | COLLECTED | 0x80000000 | ||
| MCALCLIENTDETAILS | 0x00000100 | ||||||
| MCALGATEDETAILS | 0x00000200 | ||||||
| MEDIAROUTINGGATEDETAILS | 0x00000400 |
About the Bit arithmetic
0x000... defines a number in hexadecimal format. To set/enables multiple bits simply add the hexadecimal numbers. This will
do the bitwise or. Be aware about the hexadecimal digit range from 0..f . Every hexadecimal digit represents 4 bits (one nibble).
| Hexadecimal | Decimal | Bit |
|---|---|---|
| 0x0 | 0 | 0000 |
| 0x1 | 1 | 0001 |
| 0x2 | 2 | 0010 |
| 0x4 | 4 | 0100 |
| 0x8 | 8 | 1000 |
| Hexadecimal | Decimal | Bit | Hexadecimal | Decimal | Bit | |
|---|---|---|---|---|---|---|
| 0x0 | 0 | 0000 | 0x8 | 8 | 1000 | |
| 0x1 | 1 | 0001 | 0x9 | 9 | 1001 | |
| 0x2 | 2 | 0010 | 0xa | 10 | 1010 | |
| 0x3 | 3 | 0011 | 0xb | 11 | 1011 | |
| 0x4 | 4 | 0100 | 0xc | 12 | 1100 | |
| 0x5 | 5 | 0101 | 0xd | 13 | 1101 | |
| 0x6 | 6 | 0110 | 0xe | 14 | 1110 | |
| 0x7 | 7 | 0111 | 0xf | 15 | 1111 |
Example:
Set the b+s Data Store trace mask enabling COMMUNICATION, BEGIN_METHOD, END_METHOD and COLLECTED.
Calculation of the trace bits:
COMMUNICATION 0x00000010 00000000000000000000000000010000
BEGIN_METHOD 0x04000000 00000100000000000000000000000000
END_METHOD 0x08000000 00001000000000000000000000000000
COLLECTED 0x80000000 10000000000000000000000000000000
enabling the trace level 0x0000000F 00000000000000000000000000001111
---------- --------------------------------
0x8c00001f 10001100000000000000000000011111
Prefix the numbers with 0x marks it as hexadecimal. In the .ini file, it loks like LogMask=0x8c00001f.
You can also enter the decimal value LogMask=2348810271 but we recommend the hexadecimal format.