These actions include:
The core command line formats follow:
The standard java options refer to the Java command line options such as -classpath <classpath> to set the classpath appropriately.
See the Functional Tester API Reference (com/rational/test/ft/rational_ft) for a full list of the command-line options.
The following is the list of more commonly used options:
In these examples, -classpath must point to the rational_ft.jar files.
Record a new script:
java -classpath <classpath> com.rational.test.ft.rational_ft -datastore <directory> [ -map <sharedmap>] [options] -record <script-name>Record a simplified script:
java -classpath <classpath> com.rational.test.ft.rational_ft -simplescript true -datastore <directory> [-map<sharedmapname>] [options] -record <script-name>Record into an existing script, inserting before or after a given line:
java -classpath <classpath> com.rational.test.ft.rational_ft -datastore <directory> [ -insertbefore <line>] [ -insertafter <line>] [options] -map <sharedmap>] [options] -record <script-name>Compile a script:
Play back a script, passing command-line arguments <values> to the script:
If you do not enable or disable the dynamic find feature here, the dynamic find setting on the Dynamic Find Enablement page in the Preferences dialog box, which applies globally to all scripts run in the integrated development environment (IDE), is used.
Play back a script that uses classes from other functional test projects:
java -classpath <classpath> com.rational.test.ft.rational_ft -datastore <directory> -projectpath <reference-project-path> -playback <script-name>Play back a script that uses other classes for the functional test projects:
java -projectpath <projectpath> com.rational.test.ft.rational_ft -datastore <directory> -projectpath <reference-project-path> -playback <script-name>Play back a script that has an associated datapool:
java -classpath <classpath> com.rational.test.ft.rational_ft -datastore <directory> -iterationCount <iteration value> -playback <script-name>Record, compile, and play back a script:
java -classpath <classpath> com.rational.test.ft.rational_ft -datastore <directory> [options] -record <script-name> -compile -playback [ -args <values>]Construct an empty script:
java -classpath <classpath> com.rational.test.ft.rational_ft -datastore <directory> -map <sharedmapname> [options] -create <script-name>Regenerate the helper file for a script:
java -classpath <classpath> com.rational.test.ft.rational_ft -datastore <directory> -helper <script-name>Regenerate all helper files for a datastore:
java -classpath <classpath> com.rational.test.ft.rational_ft -regenHelpers <script-name>Display an object-map file:
java -classpath <classpath> com.rational.test.ft.rational_ft -datastore <directory> -display <object-map filename>Display a verification-point file:
java -classpath <classpath> com.rational.test.ft.rational_ft -datastore <directory> -display <verification point filename>Edit an object-map file:
java -classpath <classpath> com.rational.test.ft.rational_ft -datastore <directory> -edit <object-map filename>Edit a verification-point file:
java -classpath <classpath> com.rational.test.ft.rational_ft -datastore <directory> -edit <verification point filename>Create and edit a shared-object map:
java -classpath <classpath> com.rational.test.ft.rational_ft -datastore <directory> -fromMap <object-map filename1> -createMap <object-map filename2>Merge a later version of an object map into a current (modified) version of the same map:
java -classpath <classpath> com.rational.test.ft.rational_ft -datastore <directory> -from <object-map filename1> -to <object-map filename2> -original <object-map filename1> -mergeMapCompare an actual verification point result to an expected verification point result:
java -classpath <classpath> com.rational.test.ft.rational_ft -datastore <directory> -baseline <baseline verification point filename> -compare <expected verification point filename> <actual verification point filename>Enable a configured browser, Java environment, or Eclipse platform:
java -classpath <classpath> com.rational.test.ft.rational_ft -enableName <browser/Java environment/Eclipse>Disable all configured browsers, Java environments and Eclipse platforms:
java -classpath <classpath> com.rational.test.ft.rational_ft -disableallRun the Application Configuration Tool:
java -classpath <classpath> com.rational.test.ft.rational_ft -appConfig <application name>Run the Test Object Inspector:
java -classpath <classpath> com.rational.test.ft.rational_ft -inspectorRun the Object Properties Configuration Tool:
java -classpath <classpath> com.rational.test.ft.rational_ft -objectlibraryouIf you have TestManager installed and you want to run Functional Tester unattended in batch mode with a TestManager log, you must include the following options on the rational_ft command line:
Execute a script on Windows
java -classpath "C:\IBM\RFT\FunctionalTester\bin\rational_ft.jar"
com.rational.test.ft.rational_ft -datastore \\My_project\AUser\RobotJProjects -user admin -project
\\My_project\AUser\TestManagerProjects\Test.rsp -build "Build 1" -logfolder "Default" -log
"Al_SimpleClassicsA#1" -rt.log_format "TestManager" -rt.bring_up_logviewer true -playback
basetests.SimpleClassicsA_01
If you do not want TestManager to display the log after playing the script, you must also include the following option on the rational_ft command line:
-rt.bring_up_logviewer false
The command line format is: /opt/IBM/RFT/jre/bin/java /opt/IBM/RFT/FunctionalTester/bin/rational_ft.jar<Functional Tester options>
If you use the above command-line format, you must explicitly set the functional tester environment variables. Alternatively, you can use the Functional Tester scriptft_cmdline.
Enable all environments in Linux
/opt/IBM/SDP7.0/ft_cmdline -enable ALL
Execute a script with command line arguments on Linux
/opt/IBM/SDp7.0/ft_cmdline -datastore
/opt/IBM/RFT/workspace/Project1 -log testscript -playback Script2 -args arg1 arg2