RMSimulator - Version 0.11
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

Copyright (c) 2008 Peter Wanschou
                   Universitt Klagenfurt
                   SysSec - Systemsicherheit


Was ist in dem Anwendungsordner vorhanden?
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

Nach dem Entpacken der Anwendung finden Sie folgende Verzeichnisstruktur:

  RMSimulator/     RMSimulator Root Verzeichnis
    lib/           bentigte JAR Packete
    samples/       Beispielprogramme
    image/         Bilder fr die Anwendung


Installation und Start
~~~~~~~~~~~~~~~~~~~~~~

Nach dem Entpacken stehen mehrere Mglichkeiten zum Starten des Simulators
zur Verfgung. Wenn am System die JAR-Dateiendung mit JAVA verknpft ist gengt
es die Datei RMSimulator.jar aufzurufen.

Wenn keine Verknpfung besteht knnen die Dateien
  startWindows     fr Windows
  start            fr die restlichen Systeme (Linux, MacOs etc.)
verwendet werden.

Bei den Startskripts ist wichtig, dass die Anwendung java in den Systempfaden
vorhanden sind. Ist es nicht gewnscht den Pfad in die Systemkonfiguration
aufzunehmen muss die fr das System, entsprechende Startdatei angepasst werden.



Beispielprogramme
~~~~~~~~~~~~~~~~~

Im Ordner samples finden Sie mehrere Beispielprogramme:

  avg.rma              Mittelwert von zwei Zahlen

  potenz.rma           Potenz m^n

  funktionsaufruf.rma  Es wird die Funktion potenz aufgerufen. Aus dem Beispiel
                       kann man gut erkennen, wie neue Funktionen erstellt
                       werden knnen.


Anwendungsbeschreibung
~~~~~~~~~~~~~~~~~~~~~~

Der RMSimulator besteht aus mehreren Sichten:

  RegisterView         Der RegisterView befindet sich ganz oben. Es wird der aktuelle
                       Zustand des Registers in dieser Sicht angeteigt. Ein-, Ausgabe- und
                       EinAusgabe-Register sind speziell gekennzeichnet. Das Ausgaberegister ist
                       farblich hinterlegt, damit es schnell gefunden wird.
                       
  HistoryView          Zeigt die einzelnen, ausgefhrten Verarbeitungsschritte und befindet sich
                       links unter dem RegisterView.
                       Durch klick auf eine Zeile kann im ProgramView durch eine farbliche
                       Markierung erkannt werden welche Programzeile dieses Ergebnis
                       hatte. Mit der rechten Maustaste kann die Markierung gelscht
                       werden.

  ProgramView          Der ProgramView befindet sich auf der rechten Seite. Im oberen Teil wird
                       die offenene Datei angezeigt. Neben dem Dateinamen befinden sich mehrere
                       Schaltflchen zum ffnen und Bearbeiten eines Registermaschinenprogrammes.
                       In der Programmsicht kann mit einem Doppelklick auf die erste Spalte ein
                       Unterbrechungspunkt hinzugefgt oder entfernt werden.
                       Wie im HistoryView knnen die einzelnen mit klicken markiert werden,
                       damit im HistoriyView die betroffene Zeile erkannt wird.
                       Auf der rechten Seite ist ein Balken vorhanden, der sich bei Ausfhrung
                       eine Zeile grn verfrbt. Mit dem Balken knnen nicht besuchte Zeilen
                       rasch erkannt werden.

                       Im Modus Bearbeiten knnen die Anzahl der Eingaberegister und die Position
                       des Ausgaberegisters konfiguriert werden. Die Anzahl der Eingaberegister darf
                       nicht grer als die Positon des Ausgaberegisters sein. Neben dem Eingaberegisters
                       befindet sich ein Druckknopf, der die Eingabe von Startwerten ermglicht. Es
                       wird hier auch das Programm angegeben.

  InformationView      Gibt Auskunft ber timeUniform und spaceUniform des aktuellen
                       Ausfhrungsstandes des Programmes und befindet sich unter dem ProgramView.

Die Programmsteuerung erfolg durch die Kontrollleiste:

  grner Kreis         Programm ausfhen (max 1000 Befehle, damit Endlosschleifen vermieden werden

  grner Pfeil         ausfhren eines Befehls

  roter Kreis          Programm bis zum nchsten Unterbrechnungspunkt ausfhren (max 1000 Befehle)

  rotes X              Das Programm wird zurckgesetzt und kann neu gestartet werden

  Brief                Versenden einer Fehlermeldung oder Anmerkung. Die Fehlermeldung erfolgt Anonym,
                       Es kann nicht festgestellt werden, wer sie Nachricht versendet hat, ausser
                       im versendeten Text wird der Autor genannt.


Schreiben eines Registermaschinenprogrammes:
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

Standardbefehle: LOAD, STORE, ADD, SUB, MULT, DIV, GOTO, JZERO, END

Der Befehlssatz kann beliebig erweitert. Die Befehle mssen nur der Bedingung RM=(P,2,3) entsprechen.
Fr das Schreiben von neuen Befehlen liegen Beispiele der Anwendung bei.

Eine Zeile wird als Kommentar markiert, wenn sie mit // beginnt. Der Rest der Zeile kann als Kommentar verwendet
werden. Es darf nicht ber die Zeilenlnge hinaus ein Kommentar geschrieben werden. Es muss jede Zeile mit
einem Zeilenumbruch beendet werden. In einer Programmzeile kann mit // der Rest als Kommentar markiert werden.

nderungen Version 0.1
~~~~~~~~~~~~~~~~~~~~~~
 - Initialstand, nderungen werden erst in neueren Versionen beschrieben

nderungen Version 0.11
~~~~~~~~~~~~~~~~~~~~~~~
 - Programm stoppt nun bei fehlerhaften Befehlen und markiert den Fehler in der Besuchtspalte
 - Beim ffnen einer nicht existenten Datei werden Default Werte vorbelegt
 - Programm geht beim Speichern mit einem Programmfehler nicht mehr verloren
 - Programmzeile mit dem Fehler wird herausgeschrieben, um die Fehlersuche zu vereinfachen
 - Interfaceanpassungen in internen Schnittstellen
