Zeitplan über die Befehlszeile ausführen

Sie können einen Zeitplan oder einen Test außerhalb des Eclipse-Arbeitsbereichs über die Befehlszeile ausführen und die Ergebnisse automatisch exportieren.

Vorbereitende Schritte

Bevor Sie einen Zeitplan oder Test über die Befehlszeile ausführen, müssen Sie zunächst überprüfen, ob der Pfad eine ausführbare Java™-Datei (java.exe) enthält. Eine unterstützte ausführbare Java-Datei wird zusammen mit dem Produkt bereitgestellt. Auf UNIX®-Systemen befindet sich diese ausführbare Datei im Verzeichnis .../jdk/bin/java, unter Windows® im Verzeichnis ...\jdk\bin\java.exe.Unter Linux muss ein X-Server verfügbar sein, selbst wenn die Ausführung über die Befehlszeile erfolgt. Weitere Informationen finden Sie im Thema zu Tests unter Linux über die Befehlszeile ausführen.

Vorgehensweise

  1. Wenn ein Zeitplan oder Test über die Befehlszeile ausgeführt werden soll, wechseln Sie in das Verzeichnis, das die Dateien cmdline.bat und cmdline.sh enthält. Normalerweise handelt es sich hierbei um C:\Program Files\IBM\IBMIMShared\plugins\com.ibm.rational.test.lt.cmdlineexecuteversionsdatum.
  2. Führen Sie den folgenden Befehl aus:

    cmdline -workspace vollständiger_pfad_des_arbeitsbereichs -project relativer_pfad_des_projekts -schedule relativer_pfad_des_zeitplans -eclipsehome vollständiger_pfad_von_eclipse -plugins vollständiger_pfad_des_plug-ins -configfile vollständiger_dateipfad -results ergebnisdatei -overwrite {true | false} -quiet -users nn -vmargs jvm-argumente

    Wenn ein Wert Leerzeichen enthält, setzen Sie ihn in Anführungszeichen. Wenn die Onlinehilfe zu diesem Befehl angezeigt werden soll, geben Sie von dem Verzeichnis aus, das die .bat-Datei enthält, den Befehl cmdline -help ein.

    In der folgenden Tabelle werden die einzelnen Optionen erläutert:

    Option Bezeichnung
    -workspace Erforderlich. Der vollständige Pfad zum Eclipse-Arbeitsbereich.
    -project Erforderlich. Der Pfad mit dem Dateinamen des Projekts relativ zum Arbeitsbereich.
    -eclipsehome Erforderlich. Der vollständige Pfad zum Verzeichnis mit eclipse.exe.
    -plugins Erforderlich. Der vollständige Pfad des Ordners, der die Plug-ins enthält. Dieser Ordner befindet sich normalerweise im Verzeichnis C:\Program Files\IBM\IBMIMShared\plugins.
    -schedule Optional, doch müssen Sie -schedule oder -suite angeben. Der Pfad mit dem Dateinamen des Zeitplans, der ausgeführt werden soll, relativ zum Projekt.
    -suite Optional, doch müssen Sie -suite oder -schedule angeben. Der Pfad mit dem Dateinamen des Tests, der ausgeführt werden soll, relativ zum Projekt.
    -configfile Optional. Der vollständige Pfad zu einer Datei, die Parameter für einen geplanten Testlauf oder einen Testlauf enthält. Jeder Parameter muss in einer einzelnen Zeile angegeben werden; verwenden Sie daher einen Editor, der keinen Zeilenumbruch bewirkt. Alle erforderlichen oder optionalen Parameter können in der Konfigurationsdatei festgelegt werden. Durch Befehlszeilenparameter werden die Werte in der Datei außer Kraft gesetzt. In dieser Datei dürfen keine Anführungszeichen verwendet werden, auch nicht für Werte, die Leerzeichen enthalten.
    -results Optional. Der Name der Ergebnisdatei. Der Standardname der Ergebnisdatei setzt sich aus dem Namen des Zeitplans oder Tests und einer angehängten Zeitmarke zusammen.
    -overwrite Optional. Hierdurch wird festgelegt, ob eine Ergebnisdatei mit demselben Namen überschrieben wird. Der Standardwert true bewirkt, dass die Ergebnisdatei überschrieben wird.
    -quiet Optional. Hierdurch werden alle Nachrichtenausgaben des Startprogramms inaktiviert. Nach Abschluss des Testlaufs (oder des Versuchs) kehrt das Programm einfach zur Befehlsshell zurück.
    -users Optional. Setzt die Standardanzahl virtueller Benutzer im Testlauf außer Kraft. Bei einem Zeitplan entspricht die Standardeinstellung der Anzahl der im Zeitplan-Editor angegebenen Benutzer. Bei einem Test ist die Standardeinstellung ein Benutzer. Bei Angabe dieser Option wird eine neue Kopie des Zeitplans mit der angegebenen Anzahl an Benutzern erstellt.
    -vmargs Optional. Java Virtual Machine-Argumente, die übergeben werden. Beispiel: -vmargs "-debug -Xmx512m". Die Werte stehen in Anführungszeichen, da sie Leerzeichen enthalten.
  3. Sofern Sie nicht die Option -quiet verwenden, zeigen Nachrichten an, dass ein Test oder Zeitplan gestartet oder abgeschlossen wurde.
  4. Bei Ausgabe des Befehls wird der Arbeitsbereich gesperrt. Möchten Sie den Verarbeitungsfortschritt des Zeitplans oder des Tests während der Ausführung überprüfen, rufen Sie einen anderen Arbeitsbereich auf und öffnen Sie das Projekt über diesen anderen Arbeitsbereich.
  5. Wenn wieder die Eingabeaufforderung angezeigt wird, ist die Ausführung abgeschlossen. Optional können Sie Performance Tester starten, um die Ergebnisse anzuzeigen. Wenn Sie die Ergebnisse nach einer über die Befehlszeile gestarteten Ausführung automatisch exportieren möchten, klicken Sie auf Fenster > Einstellungen > Test > Leistungstestberichte > Berichte exportieren.

Beispiel

Anmerkung: Die Konfiguration muss Informationen im Format option=wert enthalten. Pfadnamen, die Leerzeichen enthalten, müssen in der Befehlszeile zwar in Anführungszeichen gesetzt werden, in der Konfigurationsdatei dürfen allerdings keine Anführungszeichen verwendet werden. Hier eine Beispielkonfigurationsdatei:
workspace=D:\My Workspace
eclipsehome=C:\Program Files\IBM\SDP
plugins=C:\Program Files\IBM\IBMIMShared\plugins
project=myProject
schedule=mySchedule.testsuite

Nächste Schritte

Nach Ausführung des Zeitplans empfiehlt es sich, die Ergebnisse zu exportieren. Weitere Informationen hierzu finden Sie unter Berichtszähler automatisch exportieren.

Feedback