Timewindow Installation Guide

Timewindow home

Revision history

User guide

Installation guide

Time-limiting notes

Directives file

Buildtool integration

License and download

Purchase

Faqs/Known issues


	Installation and use of Timewindow requires that a Java Runtime Environment (including Swing Components) is already installed on the target computer. The following examples will assume that you have Sun's JRE, or Sun's Java SDK installed on a Microsoft Windows platform.

	Installation
	The program that performs the installation comes as a single executable Jar file. Assuming that the setup program is 'TimewindowSetup10_Eval.jar', it may be started by double clicking on its icon, which is the preferred way to start the program. If you are using a console window then make sure that the setup program is in your current directory. The program may then be started with the command java -jar TimewindowSetup10_Eval.jar The program will begin by displaying the license agreement. After you have indicated that you accept the license agreement, it will bring up the main installation window. Here you would specify the directory for the installation, and enter the registration code, if you are installing a registered edition of the software. The last step in the installation process is to click on the 'Install' button which will install Timewindow on your computer. The installation will create an executable Jar file called 'Timewindow10_Eval.jar' in the directory which was specified during installation. To uninstall Timewindow simply delete the executable jar and its associated files.


	Launching Timewindow
	This Jar file may be started by double clicking on its icon. If you are using the command line the program may be started with the command java -jar Timewindow10_Eval.jar


	Command line options
	Valid command line options that may be specified when starting Timewindow are: -logifle filename This option specifies the filename to be used for the log file that is generated. It may be used with or without the GUI. If this option is not used then the default file name of 'Timewindowlog.txt' is used. -nogui This option specifies that the GUI should not be started. It must be specified if the directives option is used. -directives filename or directives This option specifies the source for the directives that are to be used. There are two versions of this option. If a filename is given then it is taken to be the directives file containing the directives for the time-limiting. If individual directives are to be specified then each directive must start with a '-' character. An example for starting Timewindow while specifying a directives file is: java -jar Timewindow10_Eval.jar -nogui -directives mydirectives.txt Where mydirectives.txt is the name of the directives file. An example of starting Timewindow with individual directives specified in the command line is java com.leesw.Timewindow.Timewindow -nogui -directives -source_directory sourcedir -destination_directory destdir -overwrite_classfiles -timelimit_class_initializers -daterange 5 Apr 2008 to Apr 7, 2008 -log_changes


	Launching Timewindow from the classpath
	To launch Timewindow from the classpath, add the installed jar file 'Timewindow10_Eval.jar' to the classpath. Now the application can be started with a command such as java com.leesw.Timewindow.Timewindow The 'nogui' and 'directives' options can also be specified, as shown below java com.leesw.Timewindow.Timewindow -nogui -directives mydirectives.txt


	Launching Timewindow through the api
	To launch Timewindow from the api , add the installed jar file 'Timewindow13_Eval.jar' to the classpath. The methods in the 'com.leesw.Timewindow.Timewindow' class that can be used to launch Timewindow are: public static boolean timelimit(String logfile,String[] directivesArray) public static boolean timelimit(String logfile,String directiveFile) The 'logfile' specifies the filename for the log file which is generated. If it is null then the default 'Timewindowlog.txt' is used. The 'directivesArray' is an array of directive strings. Each string represents a complete directive. The 'directiveFile' specifies the file name for the directives file that is to be used. The boolean return value indicates the success or failure of the method call. A 'false' value indicates that an error has occured.


	Settings and log files
	During the course of normal operation Timewindow will create or overwrite two files in the user directory. The two files are 'TimewindowLog.txt' which keeps a log of information for each session, and 'TimewindowSettings' which maintains the current settings for the program.