JavaStar Command Reference: JavaStar Command Line Arguments


JavaStar command line switches

Command Line Flags Description
-usage Displays a list of available command line options for JavaStar
-help Same as -usage.
-sysinfo Shows system properties
-version Displays the version number of JavaStar
-logfilter flags logfile [outfile] Applies flags as filters to the log file and prints this out either to outfile (optional) or System.out (default). See Table 18-2 for a list of log file filters.
-logsum (logfile)+ [-out outfile] Summarizes the log file (or files) and prints it to outfile or to System.out. This must be the last flag.
-loghtml filter infile [outfile] Like logfilter, except extracts to HTML and filter is limited to "ET12"
-archive archivefile [logfile]+ Adds the log files into the archive. Log files already in the archive are overwritten. This must be the last flag.
-jst name.jst The JST file name to use for editing or playback.
-script classname Name of the script to use for recording or playback. This must be a fully-qualified class name.
-props propertyfile Loads user test properties from propertyfile and uses these during playback.
-llfilter flags Suppresses the log file content represented by the flags.
-llcount size Limits log count--provide size in bytes.
-workdir dir Uses dir as the output directory for recorded scripts, generated declaration classes, and as the default directory to search for scripts, declaration classes and JSTs.
-resdir dir Uses dir as the root directory for all fail files.
-jstpath searchpath Defines searchpath as the path JavaStar uses to locate components of JSTs. This uses the same syntax as CLASSPATH.
-log filename Writes the log to filename.
-scale n Scales the delay by a factor of n.
-timeout n Sets compares to timeout after n seconds.
-hangtime n Sets the interval of time (in seconds) a playback script can continue without receiving a response from the application under test. When a script reaches hangtime, it terminates in an AsynchTimeoutError.
-jvm filepath Sets the Java Virtual Machine to use for subprocesses.
-jc filepath Sets the Java compiler to use when compiling scripts.
-jcpf flag Flag to use for the JVM in place of
-classpath.
-kcpf flag Flag to use for the compiler in place of
-classpath.
-J flag Flag or argument to pass to JVM subprocess (e.g. -J-mx64m )
-K flag Flag or argument to pass to compiler subprocess (e.g. -K-g)
-jdk version Tells JavaStar which JDK your JVM is equivalent to. Must be one of 1.1.1, 1.1.2, 1.1.3, or 1.1.4.
-applet [html]+ Record all the applets in all the HTMLs at once. If you use this option, it must be the last flag.
-app classname [args]* A record option. Use this classname as the program under test and send these arguments to that program. If you use this option, it must be the last flag.
-fserve Starts up JavaStar file server to work with JavaStar for Java Plug-in.
-play Sets JavaStar to playback mode.
-1proc Run the playback in the current process rather than a subprocess. (Requires -play) You can only use this option on tests that do not contain restart nodes or crash recovery nodes. You also need to include the correct library in the CLASSPATH--for example, if you are using JDK 1.1.4, be sure to add javastar/lib/114.zip to the CLASSPATH.
-gui Shows the JavaStar Record/Playback GUI during playback.
-invisible Hides the JavaStar Record/Playback GUI during playback.
-testargs [args]* Sends the args as arguments to the test in playback. If you use this option, it must be the last flag.

Log filtering flags

Log filter flag Description
A Arguments (arguments passed to each test)
C Control (flow of control within the test)
D Other
E Event (each event executed)
H Header (system information)
M Machine
R Result
S Summary (comparison and checking results)
T Time (timestamps)
X Error
1 System.out
2 System.err




Send feedback to JavaStar-feedback@suntest.com
Copyright © 1998 Sun Microsystems, Inc. 901 San Antonio Road, Palo Alto, CA 94303. All rights reserved.