QAT Harness User Manual

1. System Menu
2. Toolbar
3. Test Tree
4. Test Selection
5. StatusBar
6. Project settings

System Menu

File

1. Run selected tests

This will run all tests currently selected in the test tree. If a directory is selected, but closed (ie no children showing), all the tests contained in this subdirectory will be run. If a selected directory is open and selected, only selected tests in this directory will be executed.
2. Stop current run

This will halt the current test run, or give an error message if no tests are currently running. The tests currently running may block if it is waiting for a GETSTATUS command result, when the corresponding process is blocked and no timeout was set when calling the CMD_START command.
3. Select all tests

This will select all the tests in the test tree, expanding all nodes to make the tests visible as well. Another way to select all the tests is to make sure the root node is closed and selected, and then select the "Run selected tests" command.
4. Re-parse the tests

The test files are parsed by the relevant ParserInterface only when a new test directory is selected, or project properties which affect the parsing of tests, has changed. A serialized version og the parsed test is used to store keyword, name, output etc. information for displaying in the test tree. Calling the re-parse command will force the GUI to reload the tests and re-parse in case changes were made to the disk versions. When a test is run, it always uses the disk version, so re-parsing tests is only neccesary to reflect changes to GUI visible parameters of a test, such as available output trace files, include file changes etc.
5. Load,, Save, Save project As

These methods are responsible for saving and loading the various run combinations you've set up.
A saved project includes all run results for each test, the parsed values for each test, the output trace files for each process started by a test, as well as the parser output for each test.
6. Exit

This will exit the GUI harness. The current project will be saved automatically.\

Edit

1. Edit project

This allows access to the project settings. The following values may be adjusted :
 

Project properties	These are any default values which are passed to the Parser when parsing the test files, and executing the test files.
Display output trace files in the test tree	If selected, the viewable stdout and stderr traces for each test will be visible as child nodes of the test node. If not selected, they may be viewed via the right click pop-up menu.
Parser class name	For use if a user has defined their own class implementing the ParserInterface
Test finder class name	For use if the user has defined their own TestFinderInterface class.
Test directory path	The root from which to search for test files.
Re-use trace viewer window	If selected, all trace view requests will appear in the same TraceViewer window. If not selected, a  new TraceViewer window will pop-up for each view requested.

2. Edit agent settings