Dialogic Voice Cards - ResultMsg tool converts Global Call result or error value to text
Description
The Dialogic Global Call API can be used with protocols of different nature such as analog POTS ('plain old telephony service'), ISDN, SS7 or IP.
During troubleshooting of some application or protocol issues using RTF logs, it may be important to know the result values that are returned by Global Call events, or what some specific error code means.
Global Call works on top of different call control libraries, and it is sometimes complicated to bind a hex or decimal value found in the RTF log to its definition or description.
The ResultMsg tool ( ) accepts decimal or hexadecimal values from the keyboard, scans all available GlobalCall call control libraries on the target machine and displays a list of result/error definitions and their brief description. For example, the RTF log shows the following:
10/14/2009 09:11:00.808 1740 1868 INFO Tsc dtiB1T1 <<--- CallState_Failed(0x00001000)
10/14/2009 09:11:00.808 1740 1868 DEBG Call dtiB1T1 <000> TSC reason = 0x17
10/14/2009 09:11:00.808 1740 1868 DEBG Call dtiB1T1 <000> Cause = 0xd7
Using the tool and having some knowledge of hardware in use, one can easily define what library sent this cause value and what this value means:
Here the screen snapshot:
Enter Result/Cause value, or 'q' to quit :\> 0xd7
*******************************************************************************
*
* | |
*
* CC Library | Value | Error / Cause
*
* | |
*
*******************************************************************************
*
GC_CC_LIB 0xd7 SIT No Circuit
Enter Result/Cause value, or 'q' to quit :\>How to use the tool
Download the ResultMsg zip file. -
Unzip and copy the executable file to the folder on the system where a Dialogic System Release is installed. Alternatively, copy whole content of the dialogic/lib or hmp/lib directory from a system where a Dialogic System Release to another computer and add the ResultMsg.exe to that folder.
Start the program, wait for the banner to appear and enter a cause or error value. Hexadecimal values must be prefixed with 0x, otherwise the tool interprets the input as a decimal number.
See the list of returned messages, select the one matching the technology used in that case.
Products
Dialogic JCT series Media Boards