Introduction to Custom Test Script Types

prevnext

Using the Command Line Execution Engine


The command-line execution engine, rttsee, lets you test your TSEA from the command line rather than from TestManager. The rttsee interface is especially useful on non-Windows platforms, and for testing your extension of the TSEE framework independently of the test scripts executed through the framework.

The following example illustrates the most common usage of rttsee. It runs a Java program named hello.java via the Java TSEA, rttseajava.dll.

rttsee -e rttseajava hello

The following example starts a TSS server listening on port 95 that continues running until explicitly stopped.

rttsee -k -P 95

The syntax of rttsee is:

rttsee [option [arg]] 

The full options are described in the following table.

Option Description
-d dir Specifies the directory for result files -- u-file (log), o-file, e-file. The default is the current directory.
-e tsea[:type] script[:type] Specifies the TSEA to start and the test script to run. If tsea handles test scripts of more than on type, :type indicates the type of script. The :type may be specified with either or both the TSEA or script, but it must match if specified with both.
-G [I | i T | t] Controls random number generation. Enter one choice (I or i, T or t) from either or both pairs:
  • I Generate unique seeds for each virtual tester, using either the predefined seed or one specified with -S (default).

  • i Use the same seed for all virtual testers, either the predefined seed or one specified with -S.

  • t Seed the generator once for all tasks at the beginning, using either the predefined seed or one specified with -S (default).

  • T Reseed the generator at the beginning of each task.

-k Keep-alive. Use with -P to start a TSS server that keeps running after all test scripts have completed execution.
-P portnumber Specifies the listening port for a TSS server that remains alive until explicitely stopped.
-r Redirects stdio to the o-file and e-file (in the directory specified by -d).
-S seed Specifies an alternative seed value for the predefined seed. Must be a positive integer except in conjunction with -G i.
-u uid Specifies the ID of a virtual tester.
-V Displays the rttsee version.

prevnext


Rational TestManager Extensibility Reference Rational Software Corporation
Copyright (c) 2003, Rational Software Corporation http://www.rational.com
support@rational.com
info@rational.com