L'exécution d'un test ou d'un planning sous Linux nécessite un serveur X Windows même si le test est lancé à partir de ligne de commande. Pour plus d'informations, voir Running tests from the command line on Linux.

cmdline -workspace chemin_complet_espace_travail -project chemin_relatif_projet -eclipsehome chemin_complet_eclipse -plugins chemin_complet_rep_plugins -schedule chemin_relatif_planning -suite chemin_relatif_suite -varfile chemin_complet_fichier_variables -servicename service -serviceargs args_service -configfile chemin_complet_fichier -results fichier_résultats -overwrite {true | false} -quiet -users nn -vmargs args_JVM -exportlog chemin_complet_journal -exportstats chemin_répertoire_local -exportstatshtml chemin_répertoire_local -compare "chemin1_résultat, chemin2_résultat"-exportstatreportlist liste_stats -usercomments "commentaire utilisateur"
Si une valeur contient des espaces, placez-la entre guillemets. Pour afficher l'aide en ligne de cette commande, entrez cmdline -help quand vous vous trouvez dans le répertoire qui contient le fichier .bat.Le tableau suivant décrit chaque option :
| Option | Description |
|---|---|
| -workspace | Requis. Chemin d'accès complet à l'espace de travail Eclipse. |
| -project | Requis. Chemin (incluant le nom de fichier) du projet relatif à l'espace de travail. |
| -eclipsehome | Requis. Chemin complet d'accès au répertoire qui contient eclipse.exe. |
| -plugins | Requis. Chemin complet du dossier qui contient les plug-ins. Sur un système Windows, il s'agit généralement du dossier C:\Program Files\IBM\IBMIMShared\plugins. |
| -schedule | Chacune des options -schedule, -suite et -servicename est optionnelle, mais il est obligatoire de spécifier l'une d'entre elles. Chemin (incluant le nom de fichier) du planning relatif au projet. |
| -suite | Chacune des options -schedule, -suite et -servicename est optionnelle, mais il est obligatoire de spécifier l'une d'entre elles. Chemin (incluant le nom de fichier) du test relatif au projet. |
| -varfile | Facultatif. Chemin complet d'accès au fichier XML qui contient les paires de nom et valeur de variable. |
| -servicename | Chacune des options -schedule, -suite et -servicename est optionnelle, mais il est obligatoire de spécifier l'une d'entre elles. Nom du service à exécuter. Au lieu d'un test de performances, le service spécifié est exécuté lorsqu'il devient disponible. |
| -serviceargs | Facultatif. Série d'arguments à passer au service spécifié par l'option -servicename. Par exemple, -serviceargs "-myserviceparm1 myserviceparm1value". Les valeurs sont placées entre guillemets car elles contiennent des espaces. |
| -configfile | Facultatif. Chemin complet d'accès à un fichier qui contient les paramètres pour une exécution de test ou de planning. Chaque
paramètre doit figurer sur une ligne à part. Pour créer un fichier de configuration, utilisez un éditeur qui ne force pas
le retour à la ligne. Tous les paramètres, qu'ils soient obligatoires ou facultatifs, peuvent être définis dans le fichier de configuration. Les paramètres de ligne de commande remplacent les valeurs figurant dans ce fichier. Remarque : Le fichier doit être au format UTF-8. N'utilisez pas de guillemets dans ce fichier, même pour les valeurs qui contiennent des espaces.
|
| -results | Facultatif. Nom du fichier de résultats. Le nom du fichier de résultats par défaut correspond au nom du test ou du planning auquel est ajouté un horodatage. Indiquez un nom de dossier en rapport avec le projet pour stocker les résultats de test. Par exemple, -results folder/resultname. |
| -overwrite | Facultatif. Détermine si un fichier de résultats portant le même nom sera remplacé. La valeur par défaut, false, indique que le nouveau fichier de résultats est créé. Si la valeur est true, le fichier est remplacé et conserve le même nom de fichier. |
| -quiet | Facultatif. Désactive la sortie des messages du lanceur et renvoie simplement à l'interpréteur de commandes lorsque l'exécution ou la tentative d'exécution est terminée. |
| -users | Facultatif. Remplace le nombre d'utilisateurs virtuels dans l'exécution. Pour un planning, la valeur par défaut correspond au nombre d'utilisateurs spécifié dans l'éditeur de planning. Pour un test, la valeur par défaut est un utilisateur. Cette option crée une nouvelle copie du planning qui contient le nombre indiqué d'utilisateurs. |
| -vmargs | Facultatif. Pour définir la taille de segment Java maximale pour le processus Java qui contrôle la lecture de la ligne de commande, utilisez l'option -vmargs avec l'argument -Xmx. Par exemple, lorsque vous utilisez -vmargs -Xmx4096m, vous définissez une taille de segment maximale de 4096m. Cette méthode revient à définir -Xmx4096m dans le fichier eclipse.ini pour le plan de travail lors de la lecture du test à partir de l'interface utilisateur. Pour une exécution cloud, spécifiez -vmargs -Dcloudcostconfirm. |
| -exportlog | Facultatif. Chemin complet d'un fichier dans lequel stocker le journal de test HTTP exporté. |
| -exportstats | Facultatif. Chemin complet d'un répertoire dans lequel stocker
les données des rapports statistiques. Ces données sont stockées au format CSV, le nom du fichier étant
dérivé du nom du rapport. Si l'option -exportstatreportlist n'est pas spécifiée,
les rapports exportés sont ceux qui sont indiqués sur la
page Exportation de rapports des préférences Rapport de test de performances. Utilisez l'attribut -timerange avec -exportstats pour exporter les données d'intervalles de temps spécifiques dans une exécution. La valeur correspond à l'intervalle de temps que vous avez indiqué dans le planning. Par exemple, "5 utilisateurs,10 utilisateurs". Séparez les intervalles de temps à l'aide d'une virgule et utilisez des guillemets lorsqu'un intervalle de temps comporte un espace. |
| -exportstatshtml | Utilisez -exportstatshtml uniquement si vous voulez exporter les résultats d'analyse Web. Les résultats sont exportés vers le répertoire spécifié. L'analyse des résultats s'effectue sur un navigateur Web sans à avoir à utiliser le plan de travail de test. |
| -compare | Utilisez l'attribut -compare avec -exportstatshtml pour exporter le résultat en mode comparaison. La valeur peut correspondre à des chemins d'accès aux exécutions qui sont relatifs à l'espace de travail. Séparez les chemins à l'aide d'une virgule. |
| -exportstatreportlist | Facultatif. Liste séparée par des virgules de chemins absolus de fichiers au format de rapport personnalisé (fichiers .view) à utiliser lors de l'exportation des données de rapports statistiques avec l'option -exportstats. Ce paramètre prévaut sur les préférences de l'espace de travail. Par exemple, -exportstatreportlist c:/customreport.view,c:/customreport2.view. |
| -usercomments | Facultatif. Ajoutez du texte entre guillemets pour l'afficher dans la ligne Commentaires de l'utilisateur du rapport. Remarque : Sous Windows, pour ajouter
des commentaires dans une langue qui ne prend pas en charge les caractères Unicode,
il est recommandé d'exécuter la commande à l'aide du fichier CommandLine.exe.
|
cmdline -workspace C:/RPTWorkspace -project testProj -eclipsehome C:\Program Files\IBM\SDP\eclipse.exe -schedule MySchedule -varfile C:/Assets/testProjVar.xml