Logging and Analyzing a Test

<< Click to Display Table of Contents >>

Navigation:  Working with Docklight >

Logging and Analyzing a Test

Preconditions

 

Docklight is ready to run a test as described in the previous use cases, e.g.

Testing a serial device or a protocol implementation

 

Logging the test

 

Click on the logging Start Logging button on the main toolbar.

 

A dialog window will open for choosing log file settings.

 

For each representation (ASCII, HEX, ...), a separate log file may be created. Choose at least one representation. Log files will have a ".txt" or ".htm" file extension. Docklight additionally adds the representation type to the file name to distinguish the different log files. E.g. if the user specifies "Test1" as the base log file name, the plain text ASCII file will be named "Test1_asc.txt", whereas an HTML HEX log file will be named "Test1_hex.htm".

 

Confirm your log file settings and start logging by clicking the OK button.

 

To stop logging and close the log file(s), click the nologging Stop Logging button on the main toolbar. Unless the log file(s) have been closed, it is not possible to view their entire contents.

 

TIP: If you have additional requirements for your log file format, e.g starting a new file every hour, you can use a Docklight script and the StartLogging method for this purpose. See also the LogFileNamesTimestamp.zip sample script (folder Extra\LogFileNamesTimestamp in your Script Samples directory).