University of Toronto  Organization Modelling Environment 
(research prototype software)

(C) Copyright 1996 University of Toronto
Permission to use this software for non-commerical purposes is hereby
granted.  This software is provided "as is" without express or implied
warranty.  This software may not be transferred or sublicensed.
Any enhancements made by the recipient of this software shall be
shared with the original copyright holders.

Acknowledgements
This software was developed as part of the project entitled "Models
for Supporting the Analysis and Redesign of Business Processes" funded
by the Information Technology Research Centre of Ontario.
Principal investigators for the project are John Mylopoulos, Ray
Reiter, Hector Levesque, Eric Yu, and Yves Lesperance.
The i* modelling framework (including the Strategic Dependency and
Strategic Rationale models) was developed by Eric Yu in his doctoral
dissertation, Department of Computer Science, University of Toronto,
1995.
This software was originally written by Chen Wang as part of his
Master degree requirement.
Substantial modifications and enhancements were made by Godfrey Cheng
and Seyil Yoon, who worked as summer students on this project, and by Mike
Bissener during the fall of 1996.
The "repository" part of the code was originally written by Brian Kramer and
subsequently modified by Chen Wang, Seyil Yoon, and Godfrey Cheng.

This directory include the following files:

README		: the installation instructions for Unix and Win95
OME-tool.zip	: the zipped Windows95-version
omefinal.tar.gz	: the 'tared' and 'gnuzipped' files of the ome tool for
		  Unix.
omefinal.tar
kb.tar.gz	: the 'tared' and 'gnuzipped' files to install kbwish
kb.tar




Installation:

	****************
	*FOR WINDOWS 95*
	****************
To install the ome-tool on your Windows 95 system, simply cop the OME-tool.Zip
file on your computer. Then unzip the file with for example Winzip. 
This file contains all th necessary files to run the OME-tool
(tcl75.dll,tk41.dll,cw3215.dll,wish41.exe,kbwish,..).
To run the tool, simply click on the ome.bat file.



	****************
	* FOR UNIX     *
	****************
Be sure to have Tcl/Tk installed !
	(vers. tk4.1 tcl7.5)

A.To install the OME-tool on your system, you will have to do several things:

	1. Copy the file ome.tar.gz on your system
	2. Decompress and untar the file
	3. This file includes a KBWISH interpreter which is necessary to run 
		the ome-tool.
	4. Make the necessary changes in the 'ome'-file:
		This file might look like this:
			
			#!/bin/sh
			TK_LIBRARY=/h/i/wings/lib/tk4.1 ; export TK_LIBRARY
			TCL_LIBRARY=/h/i/wings/lib/tcl7.5 ; export TCL_LIBRARY
			./kbwish -f ./OME_main.tcl
		
		You will have to change this path to the path where your
		Tcl/Tk library is installed.
	5. Type 'ome' and the tool should run.
	6. If it doesn't, it might be that you will have to change it to an 
		executable: chmod u+x ome
	7. If it still doesn't run, it might be that the kbwish version 
		has problem with your system. 
		You will have to install KBWISH :B.

B. To install KBWISH
	1. Copy the file kb.tar.gz on your system.
	2. Decompress and untar  the file
		The tar file is a list of 'make' and 'C++' files!	
	To make the KBWISH-file executable:
	3. Modify the file Makefile accordingly.
 		XHOME should be the directory that contains the 
		following library subdirectories of your X Window system :
		include and lib.
		INCDIRS should be the directory that contains 
		tcl.h and tk.h
		LIBDIRS should be the directory that contains:
		tcl7.5 and tk4.1
		These files should already be installed by TCL/TK

	4. Run the program make.
	
	To make the ome-tool executable:
	5. Modify the Tcl/Tk files to point to the newly created kbwish.