Die folgende Grafik verdeutlicht den EEC-Initialisierungsprozess:
Das EEC-Hauptprogramm ist die ec.exe und befindet sich im EEC-Installationsordner. Das Hauptprogramm enthält keine Programmlogik. Es sorgt für einen Windows-konformen Aufruf von Eclipse (Exe-Datei, Anzeige des Applikations-Icons beim Umschalten mit Alt-Tab etc.).
Das ec.exe startet die Java Virtuelle Maschine (VM) durch das Programm javaw.exe.
Das ec.exe übergibt die VM Argumente, die VMArgs genannt werden. VMArgs steuern zum einen das Verhalten der VM, beispielsweise den maximalen Arbeitsspeicher. Zum anderen können der VM Argumente übergeben werden, die von der Applikation, die in der VM läuft (in diesem Fall EEC), interpretiert werden.
Das zugrunde liegende Eclipse definiert Eclipse-Argumente, die zum einen ec.exe steuern, beispielsweise das An- und Abschalten der Eingangsanzeige, zum größten Teil aber während des Hochlaufs der Plattform an die VM weitergegeben werden.
Zur Initialisierung werden ec.exe Eclipse-Argumente und VMArgs übergeben. Die Auswirkung der gesetzten VMArgs auf die laufende Applikation können Sie zur Laufzeit überprüfen:
- Klicken Sie auf Hilfe > Info über EPLAN Engineering Configuration > Installationsdetails > Konfiguration (Help > About EPLAN Engineering Configuration > Installation Details > Configuration).
Die Übergabe der Eclipse-Argumente und VMArgs an das ec.exe basiert auf Standard-Eclipse-Mechanismen. Für die Spezifikation der Parameter werden zwei Mechanismen unterstützt:
- Übergabe per Batch-Datei.
- Initialisierungsdatei (ec.ini).
Initialisierung mit Hilfe einer Batch-Datei
Für die Initialisierung mit einer Batch-Datei gibt es drei Möglichkeiten:
- In der Batch-Datei wird eine bestimmte Initialisierungsdatei angegeben, welche die spezifischen Laufzeitparameter enthält.
- In der Batch-Datei werden alle relevanten Laufzeitparameter angegeben. Damit wird eine temporäre Initialisierungsdatei für die Übergabe erzeugt.
- In der Batch-Datei wird eine Initialisierungsdatei angegeben, die allgemeine Laufzeitparameter enthält, die durch weitere Angaben in der Batch-Datei erweitert werden.
Hinweis:
Für die Initialisierung per Batch-Datei werden nur die folgenden Laufzeitparameter unterstützt:
--launcher
-data
@start ec.exe^
-<Parameter1> <Parameter value1>^
-<Parameter2>
-<Parameter3> <Parameter value3>
Anmerkungen:
- Für eine bessere Übersicht sind die Parameter zeilenweise angegeben.
- Für die Übergabe an ec.exe werden die Zeilenumbrüche durch das Zeichen ^ am Zeilenende aufgehoben, sodass aus Sicht von ec.exe alle Parameter in einer Zeile stehen.
- Durch das ^-Zeichen wird der Zeilenumbruch entfernt, dadurch entsteht die Gefahr, dass z.B. ein Parameterwert am Ende einer Zeile direkt mit einem Parameter der nächsten Zeile verbunden und damit als ein String an das ec.exe übergeben wird. Ein sinnvoller Weg sicherzustellen, dass immer ein Leerzeichen eingefügt ist, besteht darin, Zeilen mit Parametern grundsätzlich mit einem Leerzeichen zu beginnen.
- Achtung: Die letzte Zeile darf das ^-Zeichen nicht enthalten!
Hinweis:
Die letzte Zeile darf das ^-Zeichen nicht enthalten!
Hinweis:
Das @-Zeichen unterbindet die Konsolenausgabe, wodurch das Konsolenfenster zusätzlich zum EEC vermieden wird).
@echo off
ec.exe --launcher.ini D:\Projects\Project1.ini
@echo off
set EEC_PATH=E:\Users\Public\EPLAN\EngineeringConfiguration\2_7_20170621-2047
set EOX=eox\model.eox
set EEC=ec.exe
set WORKSPACE=workspace
set RESOURCES=resources
pushd %cd%
cd /d %~dp0
set dp0_s=%dp0:\=/%
echo -startup > ec.ini
echo --launcher.library >> ec.ini
echo -product >> ec.ini
echo de.eplan.engineeringcenter.product >> ec.ini
echo -data >> ec.ini
echo %WORKSPACE% >> ec.ini
echo -vmargs >> ec.ini
echo -XX:MaxPermSize=128m >> ec.ini
echo -Xmx768m >> ec.ini
echo -Dorg.foederal.sn.connectionURL=eox:///%dp0_s%%EOX%?mode=rw >> ec.ini
echo -Dcom.mind8.global.resourcePath=%dp0_s%%RESOURCES% >> ec.ini
echo -Dosgi.configuration.cascaded=false >> ec.ini
echo -Dosgi.nl=en_US >> ec.ini
cd /d %EEC_PATH%
start %EEC% --launcher.ini %dp0%\ec.ini
popd
Beispiel mit Initialisierungsdatei erweitert durch spezifische Laufzeitparameter:
Die Initialisierungsdatei ec_Project1.ini:
-startup
--launcher.library
-product
de.eplan.engineeringcenter.product
-data
workspace
-vmargs
-XX:MaxPermSize=128m
-Xmx768m
Die Batch-Datei mit Laufzeitparametern:
@echo off
set EEC_PATH=E:\Users\Public\EPLAN\EngineeringConfiguration\2_7_20170621-2047
set EOX=eox\model.eox
pushd %cd%
cd /d %~dp0
set dp0_s=%dp0:\=/%
copy ec_Project1.ini ec.ini
echo -startup >> ec.ini
echo -Dorg.foederal.sn.connectionURL=eox:///%dp0_s%%EOX%?mode=rw >> ec.ini
echo -Dcom.mind8.global.resourcePath=%dp0_s%%RESOURCES% >> ec.ini
echo -Dosgi.configuration.cascaded=false >> ec.ini
echo -Dosgi.nl=en_US >> ec.ini
cd /d %EEC_PATH%
start %EEC% --launcher.ini %dp0%\ec.ini
popd
Ini-Datei-Initialisierung
Die Eclipse-Argumente und VMArgs werden in einer Initialisierungsdatei (z.B. ec.ini) spezifiziert.
Die Initialisierungsdatei hat folgendes Format:
-<Parameter1>
<Parameter value1> # Comment
-<Parameter2>
-<Parameter3>
<Parameter value3>
<...>
Bedingungen:
- Jeder Parameter steht alleine in einer Zeile, so stellen Leerzeichen im Parameter kein Problem dar.
- Besitzt ein Parameter einen Wert, so steht dieser auf der nachfolgenden Zeile
- Zeilen mit führendem Leerzeichen sowie leere Zeilen werden ignoriert.
- Kommentare stehen am Zeilenende und beginnen mit einer Raute (#)
-data #user data folder
workspace-user1
-showlocation
-pluginCustomization
configuration\userCustomization.ini
Mehr: