How to Run the Compatibility Tests

To Run the Waveset Compatibility Test Suite

1. Open a command window.

2. At the command prompt, type the lh command using the following format:

   $WSHOME/bin/lh com.sun.idm.testing.adapter.CompatibilitySuite [Options] [testName]

   Where:

   • [options] include:

     • -h: Use to access usage information

       For example:

       Usage: CompatibilitySuite [arguments]

       Valid arguments:

       Argument	Description
       -propsFile value	Path to the properties file
       -formatter value	Formatter to use for formatting output of tests
       -user value	Name of user to execute test as
       -pass value	Plain text password used to log the user on
       -import value	Comma separated list of files (on server) to import
       -toDir value	Directory to put test output in
       -v	Echoes all arguments passed in to the screen
       -h	Displays the usage message

     • -propsFile file: Use to specify a properties file name.

     • -formatter type,path: Use to specify XML, HTML, or plain text and a path in which to put this file.

   • [testName] is a comma-separated list of the tests to run.

   The following properties control how tests are executed:

   Property	Description
   adapter	Classname of the adapter to test
   dp	Name of a custom DataProvider
   importScript	Comma-separated list of paths to the scripts to execute  Note: These scripts return a string of imported XML.
   ns	DataProvider namespace
   includedTests	Comma-separated list of tests to include
   excludedTests	Comma-separated list of tests to exclude
   import	Comma-separated list of files to import

   You can specify these properties directly from the command line, or add them to a properties file specified from the command line. For example,

   lh -DpropName=propValue

   Where properties conflict, properties in the property file specified by propsFile are used.

   ---

   Note –

   When you use the [testName] command, the Compatibility Test Suite ignores the includedTests and excludedTests options.

   ---

   In most cases, the framework provided by Waveset is flexible enough to test the resource adapter. However, you can easily extend the functionality in two places if necessary:

   • You can implement the DataProvider interface to create a custom DataProvider. A custom DataProvider allows data to come from any source.

   • You can implement the CompatibilityHelper interface to provide a CompatibilityHelper. A CompatibilityHelper provides a way to initialize a resource before running tests.

   See the Javadoc for more information about implementing these interfaces and the required naming conventions.