JavaTest Desktop

The JavaTest desktop provides a set of windows and menus for you to use when specifying a configuration, running tests, browsing results, creating reports, and auditing results.

JavaTest Windows

The following table describes the windows provided by the JavaTest desktop:

Window Description
Test Manager Contains panels, menus, and controls that you use to:
  • Open and create work directories
  • Create or modify information that the JavaTest harness uses when running your tests
  • Run the tests of a test suite
  • Monitor tests and test results while they are being run
  • View test environment settings of your configuration
  • View the contents of an exclude list
  • Browse completed tests and test results
Agent Monitor Contains controls that you use to set up the JavaTest agent pool for monitoring active agents and to provide feedback about the status of both passive and active agents.
Audit Test Results Contains panels and menus that you use to generate and view audit reports of the tests in a work directory.

JavaTest Menus

The JavaTest desktop provides two types of menus for you to use when performing tasks:

Menu Type Description
Tool Menus These menus are only available for use in a specific window and are described in the section describing that window.
Desktop Menus These menus are available for use in all JavaTest windows and include:

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.

Menu Item Description
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 stores its test result files in a cache. 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 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 Shown in the File menu when window styles is set to Tabbed or SDI. Closes the current window without exiting from the JavaTest harness.

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 session.

Tasks Menu

Use the Tasks menu to open the windows required to perform specific tasks:

Menu Item Description
Monitor Agent Activity Opens a new Agent Monitor window for you to:
  • Setup the Agent Pool for Active Agents.
  • Monitor communication between the JavaTest harness and JavaTest Agents.
Audit Test Results Opens the Audit Test Results window. Only one Audit Test Results window can be open.

Windows Menu

Use the Windows menu in all window styles to select the active window by clicking on it's name in the window 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.

Help Menu

Use the Help menu to display online help for the window, JavaTest 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 Opens the help viewer and displays online help for the active window.
JavaTest Harness Opens the help viewer and displays online help for the JavaTest harness.
About the JavaTest Harness Displays information about this release of the JavaTest harness.
About the Java Virtual Machine Displays information about the Java runtime used to run the JavaTest harness.