Buildplan nach der Generierung verwenden
Dieser Abschnitt erläutert, wie die Verwendung des von Ihnen erstellten Buildplans verzögert wird. Dies ist beispielsweise dann erforderlich, wenn Sie zur Generierungszeit durch einen Netzausfall daran gehindert werden, den Code auf einem fernen System vorzubereiten. Wenn Sie die Verwendung des Buildplans auch dann verzögern möchten, wenn kein unerwartetes Ereignis eintritt, legen Sie für die Builddeskriptoroption prep bei der Generierung Ihrer Ausgabe no fest.
- Erstellen Sie eine Befehlsdatei (in unserem Beispiel die Datei 'build.bat') für die Ausführung des Buildplans. Sie müssen den Namen des Buildplans in der Datei 'build.bat' nicht fest codieren. Geben Sie stattdessen einen Eingabeparameter an, der den Namen aufnimmt.
- Starten Sie den Sicherheitsmanager (CCU Security Manager) und übergeben Sie ihn mit einem Kennwort, bevor der Buildplan ausgeführt wird. Sie können den Buildplan mehrmals nacheinander ausführen. Sie müssen den CCU Security Manager nicht jedes mal starten. Anmerkung: Aus Sicherheitsgründen enthält der mit EGL generierte Buildplan nicht das Kennwort, das zur Generierungszeit in der Builddeskriptoroption destPassword angegeben wurde. Zur Vorbereitungszeit bewahrt der CCU Security Manager eine Reihe von Kennwörtern sicher im Speicher auf.
build.bat myProgramBuildPlan.xml
Dabei ist myProgramBuildPlan der Name des Buildplans.Einzelheiten zur gleichzeitigen Vorbereitung mehrerer COBOL-Programme finden Sie unter "EGLPREP-Batchbefehlsdienstprogramm".
Befehlsdatei für die Ausführung des Buildplans erstellen
set INSTALL_PATH=InstallDirectory
set SHARED_INSTALL_PATH=SharedInstallDirectory
set JDK_PATH=jdk\jre\bin
set PLUGIN_PATH=plugins
set EGLBatchGen_JAR=com.ibm.etools.egl.batchgeneration_version\runtime\eglbatchgen.jar
set LOGGING_JAR=com.ibm.etools.logging.util_version\runtime\logutil.jar
set CCUBLDC_DIR=com.ibm.etools.egl.distributedbuild_version\executables\Win
set path=%INSTALL_PATH%\%JDK_PATH%;%SHARED_INSTALL_PATH%\%PLUGIN_PATH%\%CCUBLDC_DIR%
set classpath=%SHARED_INSTALL_PATH%\%PLUGIN_PATH%\%EGLBatchGen_JAR%;
%SHARED_INSTALL_PATH%\%PLUGIN_PATH%\%LOGGING_JAR%
cd %INSTALL_PATH%\%JDK_PATH%
java com.ibm.etools.egl.distributedbuild.BuildPlanLauncher %1
- Diese Vorlage ist für eine Befehlsdatei auf einer Windows-Plattform konzipiert und ist in ähnlicher Form auch für Linux verwendbar.
- Die Anweisung, die mit set classpath beginnt, muss in einer Zeile geschrieben werden.
- InstallDirectory ist der vollständig qualifizierte Pfad für das Verzeichnis, in dem das EGL-Entwicklerprodukt installiert ist.
- SharedInstallDirectory ist der vollständig qualifizierte Pfad für das Verzeichnis, in dem Sie die gemeinsam genutzte Ressource für das EGL-Entwicklerprodukt installiert haben. Der Pfad kann zum Beispiel C:\Program Files\IBM\SDP70Shared auf einem Windows-System
oder /opt/IBM/SDP70Shared auf einem Linux-System sein.
Wenn Sie eine vorherige Version des EGL-Entwicklerprodukts installiert und aufbewahrt haben, bevor Sie das jetzt verwendete Produkt installiert haben, ist das gesuchte gemeinsam verwendete Installationsverzeichnis möglicherweise das Verzeichnis, das bei der vorherigen Installation verwendet wurde.
- version ist die Plug-in-Version. Der Wert besteht aus drei Ziffern, die durch Punkte voneinander getrennt wurden, gefolgt von einem Zeichenfolgetrennzeichen, gefolgt vom Datum und der Uhrzeit, zu der das Plug-in erstellt wurde. Ein Beispiel ist 7.0.0.RFB_20070120_1300. Wenn mehrere Versionen desselben Plug-ins vorhanden sind, verwenden Sie die aktuellste Versionsnummer, falls kein Grund vorliegt, eine ältere Version zu verwenden. Die Versionsnummer ist in der Regel für unterschiedliche Ressourcen, die in der Befehlsdatei referenziert werden, unterschiedlich.
- %1 ist der einzige Eingabeparameter für die Befehlsdatei. Beim Aufrufen der Befehlsdatei geben Sie den mit EGL generierten Buildplan einschließlich der Dateierweiterung .xml an.
CCU Security Manager starten
- Führen Sie in der Workbench alle COBOL-Generierungen mit der Einstellung yes für die Builddeskriptoroption prep aus und stellen Sie sicher, dass für die Builddeskriptoroptionen destHost und destUserID die Host- und die Benutzer-ID-Werte im Buildplan angegeben sind. In diesem Fall empfängt der Sicherheitsmanager den Wert der Builddeskriptoroption destPassword.
- Stellen Sie alternativ dazu sicher, dass die Variablen PATH und CLASSPATH wie im vorherigen Abschnitt beschrieben (in Bezug auf 'build.bat') definiert sind und führen Sie folgenden Befehl in der Befehlszeile aus:
ccubldc -h destHost@destPort -b x -au destUserId -ap destPassword -VIn diesem Fall haben destHost, destPort, destUserID und destPassword dieselbe Bedeutung, die für die entsprechenden Builddeskriptoroptionen beschrieben wurden.
Der Befehl ccubldc führt zu einer Buildfehlernachricht, weil versucht wurde, ein nicht vorhandenes Script mit dem Namen x auszuführen. Der Befehl hat jedoch den Nebeneffekt, dass der CCU Security Manager mit dem Kennwort gestartet wird, das Sie im Befehl angegeben haben.
- Eine dritte Möglichkeit, den CCU Security Manager zu starten, besteht darin, sicherzustellen, dass die Variablen PATH und CLASSPATH wie im vorherigen Abschnitt beschrieben (in Bezug auf 'build.bat') definiert sind und der folgende Befehl in der Befehlszeile ausgeführt wird:
java com.ibm.etools.egl.distributedbuild.security.CCUconfigDas Dialogfenster Verteilte Buildsicherheitskonfiguration wird angezeigt.
- Klicken Sie auf die Registerkarte Clientelemente und geben Sie den Host, die Benutzer-ID und das Kennwort an.