<<

Inhaltsverzeichnis

Suchen

>>

 

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.

 

 

Blättern in Indexdateien

 

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.

 

 

Java-Programm als Dienst unter Windows einrichten

 

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.