EGLCMD

Der Befehl EGLCMD ermöglicht Ihnen Zugriff auf die Workbenchstapelschnittstelle. Sie müssen die Voraussetzungen erfüllen, die unter "Generierung über die Workbenchstapelschnittstelle" genannt werden. Einzelheiten zur Generierung eines main-Abschnitts und zur Generierung nach Abschnitten finden Sie unter "Generierungsmodus".

Der Befehl hat verschiedene Formate und der letzte Abschnitt in diesem Kapitel enthält detaillierte Referenzinformationen zu jedem Format für Sie.

Siehe folgende Abschnitte:

Von einer Befehlsdatei generieren und implementieren

Wenn Sie eine Befehlsdatei verwenden, verwenden Sie das folgende Format für den Befehl EGLCMD:

EGLCMD Syntaxdiagramm bei Verwendung einer Befehlsdatei

Die folgenden Beispiele gehen davon aus, dass Sie java EGLCMD in einem Verzeichnis starten, das die Befehlsdatei einschließt:

java EGLCMD "commandfile.xml"

java EGLCMD "myCommand.xml" 
   -sqlID myID -sqlPassword myPW
   -destUserID myUserID -destPassword myPass

java EGLCMD "/MyProject/MyCommands/Command1.xml" -data "c:\myWorkSpace"

java EGLCMD "/MyProject/MyCommands/Command1.xml"
    -data "myWorkSpace"
    -sqlID myID -sqlPassword myPW
    -destUserID myUserID -destPassword myPass

Stellen Sie den Inhalt für einen bestimmten Befehl in eine einzelne Zeile. Wenn Ihre Befehlsdatei sich in einem anderen Verzeichnis befindet, müssen Sie den Pfad zum Namen der Befehlsdatei hinzufügen.

main-Abschnitt und zugehörige Abschnitte generieren

Wenn Sie einen main-Abschnitt und die zugehörigen Abschnitte generieren und keine Befehlsdatei verwenden, verwenden Sie den Unterbefehl generate:

EGLCMD Syntaxdiagramm für den Unterbefehl 'generate'

Hier sehen Sie ein Beispiel, das in eine einzelne Zeile geschrieben werden muss:

java EGLCMD generate
    -generateFile "/MyProject/EGLSource/my/pkg/myProg.egl"
    -data "myWorkSpace"
    -buildDescriptorFile "/MyProject/EGLSource/myProject.eglbld"
    -buildDescriptorName myBuildDescriptor

Generierung nach Abschnitten

Wenn Sie nach Abschnitten generieren und keine Befehlsdatei verwenden, verwenden Sie den Unterbefehl generatePart:

EGLCMD Syntaxdiagramm für den Unterbefehl 'generatePart'
Hier sehen Sie Beispiele, die jeweils in eine einzelne Zeile geschrieben werden müssen:
  • Programm generieren:
    java EGLCMD generatePart 
                   -data "myWorkSpace" 
                   -project "MyProject" 
                   -part "test.my.pkg.program1"
                   -buildDescriptorFile "/MyProject/EGLSource/myProject.eglbld" 
                   -buildDescriptorName myBuildDescriptor
  • Alle IR-Dateien im Paket myPackage generieren:
    java EGLSDK generatePart 
                   -data "myWorkSpace" 
                   -project "MyProject"
                   -part "test.my.pkg.*"
                   -buildDescriptorFile "c:/myBuild.eglbld" 
                   -buildDescriptorName myBuildDescriptor
  • Ausgabe für Satzabschnitt generieren:
    java EGLCMD generatePart
                   -data "myWorkSpace" 
                   -project "MyProject"
                   -part "MyRecords.myRecord"
                   -buildDescriptorFile "/MyProject/EGLSource/myProject.eglbld"
                   -buildDescriptorName myBuildDescriptor

Ausgabe implementieren

Wenn Sie die Ausgabe implementieren und keine Befehlsdatei verwenden, verwenden Sie den Unterbefehl deploy:

EGLCMD Syntaxdiagramm für den Unterbefehl 'deploy'
Hier sehen Sie ein Beispiel, das in eine einzelne Zeile geschrieben werden muss:
  • Implementieren Sie die Ausgabe von einem einzelnen EGL-Implementierungsdeskriptor:
    java EGLCMD deploy 
                   -data "myWorkSpace" 
                   -deployDescriptorFile "/MyProject/EGLSource/myDeploy.egldd" 

Geben Sie keinen Stern (*) anstelle eines Dateinamens an, weil dann nur der erste Implementierungsdeskriptor im Alphabet verarbeitet wird und der Befehl mit einem Fehler endet.

Weitere Referenzdetails

Hier sind weitere Details in alphabetische Reihenfolge:

–bdOption bdOptionValue
Ein Optionswert, der die zugehörigen Werte im Builddeskriptor oder in der Befehlsdatei überschreibt.
Geben Sie einen Optionsnamen für bdOption an und geben Sie die zugehörigen Werte für bdOptionValue an. Die folgenden Builddeskriptoroptionen werden unterstützt:
  • desthost
  • destport
  • destuserid
  • destpassword
  • destdirectory
  • destlibrary
  • gendirectory
  • sqlid
  • sqlpassword
  • sqldb
  • sqljndiname
  • genproject
  • tempDirectory
  • templatedir
  • reservedword
  • projectid

Eine Builddeskriptoroption, die Sie angeben, wenn Sie den Befehl EGLCMD aufrufen, hat Vorrang vor derselben Builddeskriptoroption in einem Builddeskriptor (falls vorhanden), der in der EGL-Befehlsdatei referenziert wird. Die Optionen, die sich nur im EGLCMD-Befehl oder nur im Builddeskriptor befinden, gelten ebenfalls zur Generierungszeit.

–buildDescriptorFile bdFile
Der Pfad der Builddatei, die den Builddeskriptor enthält. Wie in Beziehung zu cmd beschrieben ist die Dateiposition relativ zum Stammverzeichnis des Arbeitsbereichs.

Schließen Sie den Pfad in doppelte Anführungszeichen ein.

Wenn Sie diesen Werte nicht angeben, sucht der EGL-Generator nach dem Masterbuilddeskriptor.

–buildDescriptorName bdName
Der Name eines Builddeskriptorabschnitts, der die Generierung leitet. Der Builddeskriptor muss sich auf der höchsten Ebene einer EGL-Builddatei (.eglbld) befinden.

Wenn Sie diesen Wert nicht angeben, sucht der EGL-Generator nach dem Master-Builddeskriptor.

Bitte beachten Sie, dass Debugging-Informationen nie in der generierten Ausgabe eingeschlossen sind, selbst wenn Sie einen Builddeskriptor für Debug angeben.

cmdFile
Der Pfad einer EGL-Befehlsdatei. Die Position ist relativ zum Stammverzeichnis des Arbeitsbereichs. Eine Befehlsdatei kann sich im Projekt 'MyProject' im Ordner 'MyCommands' befinden und trägt möglicherweise den Namen 'Command1.xml'. Hier finden Sie die Spezifikation für die Befehlsdatei:
/MyProject/MyCommands/Command1.xml
Anmerkung: Bei Pfadname von Eclipse muss die Groß-/Kleinschreibung beachtet werden.

Schließen Sie den Pfad in doppelte Anführungszeichen ein.

Die Befehlsdatei muss sich in Ihrem Arbeitsbereich befinden, bevor Sie den Befehl EGLCMD ausführen. Wenn sich die Befehlsdatei nicht in Ihrem Arbeitsbereich befindet, verwenden Sie den Importprozess von Eclipse, um die Datei zu importieren und anschließend den Befehl EGLCMD erneut auszuführen.

–data workSpace
Der absolute oder relative Pfad des Arbeitsbereichsverzeichnisses. Relative Pfade beziehen sich auf das Verzeichnis, in dem Sie den Befehl ausführen.

Wenn Sie keinen Wert angeben, greift der Befehl auf den Eclipse-Standardarbeitsbereich zu.

Schließen Sie den Pfad in doppelte Anführungszeichen ein.

–deploymentDescriptorFile deploymentDescriptorFile
Der Pfad des EGL-Deploymentdeskriptors. Wie in Beziehung zu cmd beschrieben ist die Dateiposition relativ zum Stammverzeichnis des Arbeitsbereichs.

Schließen Sie den Pfad in doppelte Anführungszeichen ein. Sie können entweder den Namen der Datei oder einen Stern (*) angeben, der alle EGL-Implementierungsdeskriptoren im Pfad darstellt.

–generateFile genFile
Der Pfad der EGL-Datei, die den Abschnitt enthält, den Sie verarbeiten möchten. Wie in Beziehung zu cmd beschrieben ist die Dateiposition relativ zum Stammverzeichnis des Arbeitsbereichs.

Schließen Sie den Pfad in doppelte Anführungszeichen ein.

-part qualifiedPartName
Der Abschnitt, den Sie generieren möchten, wird durch den Paketnamen qualifiziert. Schließen Sie den Pfad in Anführungszeichen ein. Die Abschnittsposition wird vom EGL-Buildpfad aufgelöst. Um jeden Abschnitt im Paket und in den Unterpaketen zu generieren, verwenden Sie einen Stern (*) anstelle des Abschnittnamen.
-project projectName
Der Name des Projekts im Arbeitsbereich. Der EGL-Buildpfad, der für das Projekt angegeben wurde, wird verwendet, um die Abschnittsreferenzen aufzulösen.
-symparm symparm = value
Ein symbolischer Parameter und der zugehörige Wert. Wenn der Wert ein Leerzeichen enthält, schließen Sie den Wert in Anführungszeichen ein. Wenn mehrere symparm-Einträge denselben symbolischen Parameter referenzieren, ist der letzte Eintrag wirksam.

Die symbolischen Parameter, die Sie angeben, wenn Sie den Befehl EGLCMD aufrufen, haben Vorrang vor den symbolischen Parametern mit denselben Namen im Builddeskriptor (falls vorhanden), der in der EGL-Befehlsdatei referenziert wird. Die Parameter, die sich nur im Befehl EGLCMD oder nur im Builddeskriptor befinden, sind zur Generierungszeit ebenfalls wirksam.


Feedback