Desktop Menus

The following table describes the two types of menus that the JavaTest harness provides for you to use when performing tasks.

Menu Type Description
Desktop Menus These menus are displayed by the top-level window or windows set by the current desktop style and are always available. They include the following menus:
Tool Menus These menus are unique to specific tools and are only displayed in the appropriate tool window. For a description of the Test Manager menus, see Test Manager Window . For a description of the Audit Test Results menus, see Audit Test Results Window .

If your test suite uses the JavaTest harness agent, see the JavaTest harness Agent Monitor User's Guide for a description of the Agent Monitor menus.

File Menu

Use the File menu to open files, set user preferences, close windows, and exit from the JavaTest harness. The contents of the File menu change dynamically, based on the context of the desktop. The JavaTest harness only enables menus when they can be used. The following table describes the contents of the File menu.

Menu Item Description
Open Quick Start Wizard Opens the Quick Start Wizard for you to use for the following tasks:
  • Selecting a test suite, work directory, and a configuration file to use for running tests. If the configuration file is new or incomplete, the JavaTest harness opens the configuration editor window after the Quick Start Wizard closes.
  • Resuming work on a previous test run or browse a test suite without running tests.
  • Browsing the contents of a test suite.
Create Work Directory Opens a file chooser dialog box for you to use in creating a new work directory for the current test suite.

When you create a work directory, the JavaTest harness associates it with the current test suite.

Each work directory is associated with a specific test suite and contain info about results from previous runs. The test result files contain all of the information gathered by the JavaTest harness during test runs.

Open Work Directory Opens a file chooser dialog box you can use to choose an existing work directory. The JavaTest harness changes the icon in the file chooser for any recognized work directories.

The JavaTest harness associates the work directory with an open test suite if the test suite is both a match and has no other work directory already open.

If the JavaTest harness cannot associate the work directory with an open test suite, it opens a new Test Manager window and loads both the work directory and its associated test suite.

Open Test Suite Opens a file chooser dialog box you can use to choose a test suite. The JavaTest harness changes the icon in the file chooser for any recognized test suites.

When you choose a test suite, the JavaTest harness loads the test suite in an empty Test Manager window.

Preferences Opens the JavaTest harness Preferences dialog box for you to set the display and functional options of the JavaTest harness.
File History Displays a list of work directories and test suites that have been opened.

Choose a file from the list to open a new instance of it in the current session.

Close Closes the current window without exiting from the JavaTest harness. Shown in the File menu only when the window style is set to Tabbed or SDI. See Change Window Styles for a description of the Tabbed and SDI window styles provided by the GUI.

Closing a Test Manager window closes a test session. To start another session using the same test suite and work directory, use the Open Work Directory menu above.

Exit Exits from the JavaTest harness. When you exit, your current desktop is saved so that all open windows can be restored in your next JavaTest harness session.

Windows Menu

The Windows menu contains an Open submenu that you can use to open additional windows required to perform specific tasks. The Windows menu also provides a list of all windows currently open in the JavaTest harness. You can navigate to any open window by clicking on its name in the list.

In MDI and SDI window styles, you can also use the Windows menu to manage the layout of the open windows. See Arranging the Windows Layout for a description of how you can use the Windows menu to manage the window layout. See Change Window Styles for a description of the MDI and SDI window styles provided by the GUI.

Menu Item Description
Agent Monitor See the JavaTest Harness Agent User's Guide for a detailed description.
Test Results Auditor Opens the Test Results Auditor window. Only one Test Results Auditor window can be open.

Help Menu

Use the Help menu to display online help for the window, JavaTest harness online help, available test suite documentation, JavaTest harness information, and current Java runtime information. Test suite supplied entries may also be listed in the Help menu.

Menu Item Description
Active Window Name Opens the help viewer and displays online help for the active window. This menu item is only available in an open tool window.
JavaTest harness Online Help Opens the help viewer and displays online help for the JavaTest harness.
Test Suite Documentation (optional) If the test suite provides online documentation, the JavaTest harness lists it here. Clicking the document name opens the help viewer and displays the test suite online document.
About the JavaTest Harness Displays information about this release of the JavaTest harness.
About the Java Virtual Machine Displays information about the runtime used to run the JavaTest harness.