Ablauf eines Ebus-Programms
Das
Ebus-Programm wird auf Betriebssystemebene durch eine Kommandoprozedur
gestartet, die Java Laufzeitumgebung Version 1.5 oder höher muss dazu
installiert sein:
run_<Programmname>.bat (Windows)
bzw.
run_<Programmname>.sh
(Unix/Linux).
Nach
dem Start werden zuerst alle Variablen des Programms initialisiert. Numerische
Hilfs- und Indexdateivariablen werden mit Null, alphanumerische Hilfsvariable
mit dem Leerstring und alphanumerische Indexdatei-Variable mit Leerzeichen
entsprechend ihrer Feldlänge initialisiert.
Bevor
die Hauptmaske (Mainwindow) angezeigt wird, wird die Konfigurationsdatei <Programmname>.jni
gelesen. In dieser Datei sind alle Programmeinstellungen, die Farben, Look and
Feel, usw. betreffen, gespeichert (siehe Konfiguration).
Anschließend
wird - falls vorhanden - der Makro vor Index-Open ausgeführt. In
diesem Makro können z.B. die Pfadnamen, die physikalischen Namen und der
Zugriffsmodus der Indexdateien festgelegt werden. Danach werden die im Programm
verwendeten Indexdateien geöffnet. Dabei wird überprüft, ob Indexdateien defekt
sind. Ist dies der Fall, so erscheint für jede defekte Indexdatei eine Meldung:

Wird
Nein gewählt, so wird das Programm mit Fehlermeldung beendet,
andernfalls wird die Indexdatei reorganisiert.
Nach
dem erfolgreichen Öffnen der Indexdateien wird - falls vorhanden - der Makro
nach Index-Open ausgeführt. Erfolgt in diesem Makro ein Sprung zu einem
Maskenfeld (GOTO #...), wird sofort zu der
entsprechenden Maske gesprungen. Andernfalls wird nach der Ausführung des Makro
nach Index-Open die Maske mit der niedrigsten Maskennummer
angesprungen.
Beim
Ansprung wird zuerst die Maske am Bildschirm angezeigt. Dabei werden die Makros
Makro vor Maskenausgabe und Makro nach Maskenausgabe
ausgeführt.
Für
jede Maske wurde im Layout eine bestimmte Feldreihenfolge festgelegt. In dieser
Reihenfolge werden die Felder abgearbeitet. Wird eine Eingabe in einem
Maskenfeld mit <RETURN>, <→|> oder <↓> beendet, so wird als nächstes zu dem Maskenfeld
gesprungen, das die nächsthöhere Reihenfolgenummer besitzt. Existiert kein
derartiges Maskenfeld, so wird zum ersten Feld der Maske gesprungen, wenn der
Schalter ROTATE eingeschaltet ist (ENABLE ROTATE).
Wird
im Eingabefeld die Taste <|←> oder <↑> gedrückt, so wird zum
Maskenfeld mit der nächstniedrigeren Reihenfolgenummer gesprungen. Existiert
auf der aktuellen Maske kein derartiges Feld, so wird zum letzten Feld der
Maske gesprungen, wenn der Schalter ROTATE eingeschaltet ist (ENABLE ROTATE).
Beim
Anspringen eines Feldes wird immer - falls vorhanden - zuerst der zugehörige Makro vorher ausgeführt.
Wird in diesem Makro ein Datensatz einer Indexdatei gelesen (z.B. mit READ,
START, READS, READ-NEXT usw.), so werden unmittelbar nach der Ausführung des
Makros alle Maskenfelder der
aktuellen Maske neu angezeigt, es sei denn, dass dies durch die Anweisung NODISPLAY unterdrückt wurde oder der Schalter
AUTODISPLAY auf DISABLE steht. Erfolgt im Makro
vorher kein Sprung zu einem anderen Maskenfeld (GOTO
#...), so wird nach der Ausführung des Makros das aktuelle Maskenfeld neu
angezeigt, d.h. der Wert der mit dem Maskenfeld verknüpften Variablen wird am
Bildschirm ausgegeben.
Bei
nicht änderbaren Maskenfeldern wird nach der Ausführung des Makro
vorher und der Anzeige des Maskenfeldes zum (in der Feldreihenfolge)
nächsten Maskenfeld gesprungen. Dort wird als erstes dann wieder der zugehörige
Makro
vorher ausgeführt.
Bei
änderbaren Maskenfeldern erwartet das Programm nach der Ausführung des Makro
vorher die Eingabe des Benutzers. Wird die Feldeingabe mit
<RETURN>, < →|> oder <↓> abgeschlossen, so wird anschließend - falls vorhanden - der Makro
nachher ausgeführt. Wird in diesem Makro ein Datensatz einer Indexdatei
gelesen (z.B. mit READ, START, READS, READ-NEXT usw.), so werden wie beim Makro
vorher unmittelbar nach der Ausführung des Makros alle Maskenfelder der aktuellen Maske neu angezeigt, falls dies
nicht durch die Anweisung NODISPLAY
unterdrückt wurde und ENABLE AUTODISPLAY gesetzt
ist.
Achtung: Der Makro nachher eines Maskenfeldes wird nicht ausgeführt, wenn die
Feldeingabe mit <Esc>, <|←> oder <↑> abgeschlossen wird.
Erfolgt
im Makro
nachher kein Sprung zu einem anderen Maskenfeld, so wird nach der
Ausführung des Makros das (in der Feldreihenfolge) nächste Maskenfeld
angesprungen.
Wird
in einem Maskenfeld die Taste <Esc> gedrückt, so wird die Maske beendet.
Besitzt
eine Maske keine Maskenfelder, so wird nach der Anzeige der Maske der Makro
für Maskenverarbeitung ausgeführt.
Ist
das aktuell bearbeitete Maskenfeld mit einer Indexdateivariablen verknüpft, so
kann in diesem Maskenfeld mit <F3> und <F4> in der zugehörigen
Indexdatei vorwärts und rückwärts geblättert werden. Geblättert wird dabei in
dem Schlüssel, der durch das Attribut Blättern in Key bei den
Maskenfeldattributen festgelegt wurde. Wurde kein Schlüssel festgelegt, so wird
in dem Schlüssel geblättert, in dem das Indexdateifeld als erstes vorkommt.
start_service.bat installiert ein Programm
als Dienst unter Windows.
Der
Aufruf von start_service.bat muss mit folgenden Parametern erfolgen:
start_service
<Programm-Name> <Programm-Pfad>
<Programm-Name> ist der Name des Programms,
z.B. Fakturat
<Programm-Pfad> muss das Verzeichnis
enthalten, in dem das Programm <Programm-Name> als Dienst gestartet
werden soll. In diesem Verzeichnis müssen auch die Dateien prunmgr.exe
und prunsrv.exe liegen.
Folgendes
Kommando startet den Dialog zum Starten und Beenden des Dienstes:
prunmgr
//ES//<Programm-Name>
Folgendes
Kommando deinstalliert den Dienst:
prunsrv
//DS//<Programm-Name>
Zum
Starten eines Client-Programmes als Dienst unter Windows siehe Ebus-2T-Server.