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:
java -classpath <classpath> com.rational.test.ft.rational_ft -datastore <directory> -log <logname> [options] -playback <script-name> [ -args <values>]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