Logging

If logging is enabled, all test output and test results are written out to a log file.

There are two types of log file that XJRunner can generate - plain text and formatted log files.

Plain Text Log Files

Plain text log files are text files containing the output of the tests in a plain text format.

Formatted Log Files

Formatted log files contain the output as it is displayed on the run tests screen in XJRunner. These allow the interaction with the test output that is possible on the Run Tests screen including expanding/collapsing sections and clicking hyperlinks to view nets/pins in the Layout Viewer, Schematic Viewer and Explorer. Formatted log files are opened in the Log File Viewer.

Because a log file may be shared between multiple XJLinks or even multiple instances of XJRunner over a network, output is not immediately written to the final destination. For plain text log files, output it is written to a temporary file. Then once testing has finished it is appended as a contiguous block of text. Formatted log files work in a similar way; output for a test run is not added until the test run has completed. This avoids output from different sources being interleaved in the file and keeps all the output for a board together.

Exporting Log Files Manually

The output on the Run Tests screen can be exported manually to a log file by right-clicking the screen and selecting Export to File from the context menu.