JCK Tools

This chapter contains information about programs, which are installed with JCK, but can be run separately to perform various JCK—related tasks.

F.1 Quick Configuration Editor

Quick Configuration Editor (QCE) is a standalone utility that helps you to configure JCK via a dialog box with a number of screens that contain properties for editing. You can use QCE to edit specific properties in the selected configuration.

Note - Quick Configuration Editor is an early access feature that is currently under development. Sun encourages you to use QCE for evaluation purposes only.

F.1.1 Starting Quick Configuration Editor

QCE is included with the JCK installation. JCK also installs the following scripts for each platform that can be used to start QCE:

Note - Make sure JAVA_HOME environment variable is set or Java launcher can be found via the PATH environment variable before running QCE start scripts.

• For Solaris environment use <JCK-HOME>/solaris/bin/jckconfigedit.sh script

• For Linux environment use <JCK-HOME>/linux/bin/jckconfigedit.sh script

• For Windows environment use <JCK-HOME>\win32\bin\jckconfigedit.bat batch file

Command line options are not supported in this version of QCE.

When you run QCE, you will see the initial screen in which you can select to either create a new configuration for a test suite or load the existing configuration for editing.

To create a new configuration

1. In the initial screen of the QCE, click New Configuration.

   The Configuration Parameters dialog box opens.

   
   
2. In the Configuration Parameters dialog box, you can perform one of the following:
   • Select a test suite and create a work directory
   • Select a work directory and the test suite will be selected automatically

     ---

     Note - For both options you can click Browse if the item is not listed.

     ---

To edit an existing configuration

1. In the initial screen of the QCE, click Load Configuration.

   The Configuration Parameters dialog box opens.

   
   
2. In the Configuration Parameters dialog box, select the configuration file (JTI) that you want to edit. Click Browse if the file is not listed.

   Once you create a new configuration or load the existing one for editing, the main window of the Quick Configuration Editor opens. The left pane contains a list of option groups. When you select an option group, all options of the selected group are displayed in the right pane.

   
   

F.1.2 Tips for Using Quick Configuration Editor

This chapter explains some concepts of QCE and provides some tips for working with the editor.

• Fields marked with red color and with an exclamation mark denote mandatory options.

  ---

  Note - The number of mandatory fields in the interview configuration depends on the selected “tests to run”. For example, if you select only api/javax_swing tests, the Network options become optional.

  ---

• Option groups in the left pane marked with red denote that mandatory options in this group do not have appropriate values, thus making the configuration incomplete.

  

• You can edit the options in different option groups in any order.

• To save the configuration, click File > Save or File > Save As.

• To exit the editor without saving the configuration, click Cancel. To exit the editor saving the configuration, click OK.

F.2 JCK Test Extractor Tool

The JCK Test Extractor is a command-line tool that can extract sources of a single test from the test suite. You can use this tool for tracing tests, reproducing failures or performing other tasks for which having a set of test sources would simplify the process.

Note - Extracted and compiled tests can not be used for certification process.

To use the Extractor tool, run it with the following command-line options:

java —Xmx128m —Xms128m —cp <jck>/lib/jtjck.jar com.sun.jck.lib.extracttest.Main [options] testURL

where options are as follows

• -tckRoot <path>

  <path> is the path to the TCK root to extract the selected test from (default - current)

• -o <path>

  <path> is the path to the output directory (default - current)

Note - Refer to the glossary for a test URL definition.

Note - To simplify the tool usage, run one of the following platform dependent scripts:

• <jck>/solaris/bin/testextractor

• <jck>/linux/bin/testextractor

• <jck>/win32/bin/testextractor

To extract the sources for the api/signaturetest/sigtest.basic.html#basic test to the work directory, execute the following command:

java -Xmx128m -Xms128m -cp <jck>/lib/jtjck.jar com.sun.jck.lib.extracttest.Main -tckRoot <jck> -o <workdir> api/signaturetest/sigtest.basic.html#basic

or you can use the script corresponding to your platform:

<jck>/{linux|solaris|win32}/bin/testextractor -o <workdir> api/signaturetest/sigtest.basic.html#basic

Note - In some cases you will not be able to compile extracted sources to binary form without using special tools, which may be privately owned by Sun Microsystems (e.g. files with *.jasm and *.jcod extensions).

Note - For information about Test Extractor tool issues and limitations, refer to the Known Issues section of JCK Release Notes.