Readme Notes

D-OMAR (Distributed Operator Model Architecture) V4.3

These notes for version 4.3 of D-OMAR cover:

1. Platform and software requirements

2. Installation instructions for Windows platforms

3. Instructions for viewing the D-OMAR User/Programmer Manual.

1. Platform and Software Requirements

There are three potential versions of the D-OMAR release:

- For Windows

- For LINUX

- For UNIX

For the present, LINUX and UNIX users will have to start from the Windows zip file. 

In addition, the following software (not provided) is required for model development:

- Allegro LISP Version 6.2,  7.0,  or 8.0; D-OMAR V4.3 operates under mlisp as well as alisp

- emacs that is linked to Allegro (or you favorite LISP development environment)

- JDK (Java Development Toolkit) version 1.5 (if you want to write Java code)

2 Installation Instructions

After installing the D-OMAR software, you can find information on running D-OMAR under UNIX or Windows in Chapter 4 of the D-OMAR User/Programmer Manual. It provides instructions for starting LISP, launching core-OMAR, loading your models, and starting the D-OMAR Developer Interface, the DOMAR Toolbar.

2.1 Windows Installation.

The source files for the Windows release are provided in a zip file named: Omar_43.zip

You can download the zip file from this web site by clicking on the word “download” and choosing “FTP download for Windows”.

After downloading the file, use WINZIP to unpack the zip file. You will need to indicate a directory (preferably c:\) into which to extract the source files. The extraction process creates an OMAR directory in the file you indicated.

2.2 Content of the D-OMAR Release

After unpacking the software, you should see the top-level OMAR directory and three sub-directories as follows (the sub-directories contain other files not shown here):

omar/---|--java/

| |--src/

| |--lib/

| |--scripts/

|

|--lisp/--|--core-omar/

| |--data/

| |--start-domar.lisp

|

|--manual

java/:

src/ : Java source code

lib/ : D-OMAR specific java .jar files.

scripts/ : scripts for launching Java modules of the D-OMAR system.

lisp/:

core-omar/ : Binaries for LISP module of D-OMAR system.

data/ : Sources for models used in D-OMAR system.

start-domar.lisp : LISP file for starting the server, core-OMAR

manual/: The .html files for the D-OMAR User/Programmer Manual for Version  4.0 (it has not been updated since V4.0)

2.3 Getting Started

Start Allegro Common Lisp and execute the following command in a Lisp window to launch the Lisp version of D-OMAR:

                :ld omar\lisp\start-domar

Alternately, you can ":ld omar\lisp\start-domar-psych-atc" to launch D-OMAR with a simple example scenario ready to be executed.

Executing DOMARtoolbar.bat (in omar\java\scripts) will bring up the toolbar to launch the Lisp version of D-OMAR. It includes the following pointer to the Java JRE that must be changed if the JRE is at another file location.

                    set JAVADIR=c:\progra~1\jdk1.5.0_06\jre\bin

If start-domar-psych-atc has be loaded, you can click on the "Simulator" button in the toolbar and then "Initialize" and "Run" the ATC-SCENARIO in the Simulation Control window.

3. Accessing the D-OMAR User/Programmer Manual

You can access the D-OMAR User/Programmer Manual from this web site by clicking on

“Documentation”. The .html files for the D-OMAR User/Programmer Manual are also supplied with the release. To view these local pages from your browser, use the File/Open command on your browser to open the following file:

omar/manual/index.html

Or you can type the full pathname of this file directly into the browser’s address or location field.