Customizing the JavaTest GUI

This topic describes the graphical user interface (GUI) that the JavaTest harness provides for running, managing, and auditing tests and how you can customize it for your use.

Refer to Using a JavaTest Agent for a description of the user interfaces that the JavaTest harness provides for agents running tests on remote systems.

The JavaTest GUI

The JavaTest GUI contains a set of windows and menus that you use to configure and run tests, monitor test and agent status, evaluate and analyze test results, and include or exclude tests from test runs.

You can display the graphical user interface in one of three styles:

Differences between the window styles are described in the Changing Appearance Preferences.

The JavaTest GUI Windows

The JavaTest graphical user interface provides a set of windows for you to use when running and managing tests:

Window Description
Test Manager Contains panels, menus, and controls that you use to:
  • Open and create work directories
  • Create or modify the 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 Window Contains panels and menus that you use to generate and view audit reports of the tests in a work directory.

JavaTest Menus

The JavaTest GUI 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.
Standard 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
Open Test Suite Opens a file chooser dialog box you can use to choose a test suite.

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

Open Work Dir Opens a file chooser dialog box you can use to choose an existing work directory.

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.

New Work Dir 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.

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 Managing JavaTest Windows 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:

Menu Item Description
active window Opens the help viewer and displays online help for the active window.
JavaTest Opens the help viewer and displays online help for the JavaTest harness.
User's Guide Displays information about the location of the JavaTest User's Guide.
About JavaTest Displays information about this release of the JavaTest harness.
About Java Displays information about the Java runtime used to run the JavaTest harness.

Copyright (c) 2002 Sun Microsystems, Inc. All rights reserved.