User:Jcreer/SMS:Bug Trace: Difference between revisions

From XMS Wiki
Jump to navigationJump to search
No edit summary
No edit summary
Line 7: Line 7:


Perform a bug trace by doing the following:
Perform a bug trace by doing the following:
* Run the trace_configure.bat file.
# Run the trace_configure.bat file.
*: This will create two files (debug_xms_trace.dbg and debug_xms_log.dbg) in the C:\temp\ directory and delete the DebugLog.txt if it exists.
#: This will create two files (debug_xms_trace.dbg and debug_xms_log.dbg) in the C:\temp\ directory and delete the DebugLog.txt if it exists.
* copy the smsTraceFile to the where SMS is located on your machine. "C:\Program Files\SMS 12.2 64-bit"
# copy the smsTraceFile to the where SMS is located on your machine. "C:\Program Files\SMS 12.2 64-bit"
* Run the smsTrace122.exe until finished tracing.
# Run the smsTrace122.exe until finished tracing.
* Execute the SMS function that causes your issue.   
# Execute the SMS function that causes your issue.   
*:  This should cause the crash/hang.
#:  This should cause the crash/hang.
* Return the C:\temp\DebugLog.txt to Aquaveo tech support.
# Return the C:\temp\DebugLog.txt to Aquaveo tech support.
*: This file contains the trace and may be viewed in an editor.
#: This file contains the trace and may be viewed in an editor.
* Run the trace_clear.bat
# Run the trace_clear.bat
*: This will remove the debug_xms_*.dbg files.
#: This will remove the debug_xms_*.dbg files.

Revision as of 15:10, 13 June 2018

When SMS appears to have bug, performing a trace can help the developers isolate the cause. Having a bug trace report significantly increase the speed in which issues with the software can be resolved.

To perform a bug trace, the following files are needed:

  • smsTrace122.exe
  • trace_configure.bat
  • trace_clear.bat

Perform a bug trace by doing the following:

  1. Run the trace_configure.bat file.
    This will create two files (debug_xms_trace.dbg and debug_xms_log.dbg) in the C:\temp\ directory and delete the DebugLog.txt if it exists.
  2. copy the smsTraceFile to the where SMS is located on your machine. "C:\Program Files\SMS 12.2 64-bit"
  3. Run the smsTrace122.exe until finished tracing.
  4. Execute the SMS function that causes your issue.
    This should cause the crash/hang.
  5. Return the C:\temp\DebugLog.txt to Aquaveo tech support.
    This file contains the trace and may be viewed in an editor.
  6. Run the trace_clear.bat
    This will remove the debug_xms_*.dbg files.