Le Tableau 1 décrit les paramètres de l'application de révision de code :
| Paramètre | Type | Description |
|---|---|---|
| -application | Obligatoire | com.ibm.rsaz.analysis.commandline.AnalyzeApplication Ce paramètre permet d'indiquer l'identificateur Eclipse de l'application de révision de code. Définissez l'identificateur exactement comme mentionné ci-après : com.ibm.rsaz.analysis.commandline.AnalyzeApplication. |
| -data | Obligatoire | Ce paramètre indique le chemin de l'espace de travail Eclipse utilisé par l'application de révision de code. Il doit s'agir d'un chemin qualifié complet. Si l'espace de travail indiqué n'existe pas, il est créé. Si vous utilisez également le paramètre -projects, l'application de révision de code recherche les projets spécifiés dans cet espace de travail. Si vous ne spécifiez ni le paramètre -projects ni le paramètre -directory, l'application de révision de code analyse tous les projets de l'espace de travail spécifié. |
| -rulefile | Obligatoire | Ce paramètre indique le chemin qualifié complet d'un fichier de règles contenant un ensemble de règles de révision de code et la gravité correspondante. L'application de révision de code applique ces règles aux projets ou fichiers indiqués au démarrage de l'application. Pour le COBOL, les règles peuvent inclure des catégories et des règles personnalisées ainsi que des règles personnalisées écrites par l'utilisateur. Les règles destinées au COBOL et à Java™ peuvent se trouver dans le même fichier de règles. Lors du traitement, l'application de révision de code détermine le langage de programmation de chaque fichier de code source qu'elle détecte, puis lui applique les règles qui sont applicables à ce langage. Le fichier de règles doit avoir l'extension .dat. Il doit se trouver dans le système de fichiers du poste sur lequel les fichiers eclipse.exe lancés sont installés. Il n'est pas possible d'y accéder via un réseau ou via l'Intranet ou Internet. Vous créez le fichier de règles en cliquant sur Exporter afin d'exporter les règles sélectionnées à partir de l'éditeur de configuration d'analyse. |
-projects |
Facultatif | Ces 2 paramètres indiquent l'emplacement des fichiers de code source à analyser. Vous pouvez également utiliser les paramètres -includefile et -excludefile pour inclure ou exclure des fichiers spécifiques. Utilisez -projects lorsque les fichiers de code source se trouvent dans un projet situé dans l'espace de travail que vous indiquez dans le paramètre -data. Utilisez -directory lorsque les fichiers de code source se trouvent dans un projet situé en dehors de l'espace de travail que vous indiquez dans le paramètre -data. Si vous n'indiquez ni -projects ni -directory, l'application de révision de code analyse les fichiers de code source dans tous les projets de l'espace de travail indiqué. Si vous indiquez -projects P1[, P2, P3 ...], l'application traite tous les fichiers de code source de la liste de projets séparée par des virgules P1, P2, P3...... Si vous indiquez -directory D1[, D2, D3, ...], l'application traite tous les fichiers de code source de la liste de répertoires séparée par des virgules D1, D2, D3, ..... Si vous indiquez à la fois -projects et -directory, l'application traite le paramètre -projects et ignore le paramètre -directory. Projets temporaires créés avec le paramètre -directory : la discussion suivante concerne les répertoires situés en dehors de l'espace de travail indiqué dans le paramètre -data. L'utilisation du paramètre -directory a 2 effets :
ATTENTION : N'utilisez pas l'option -directory pour désigner les répertoires qui sont situés à l'intérieur de l'espace de travail que vous indiquez dans le paramètre -data. En effet, vous créez ainsi dans l'espace de travail des projets temporaires qui sont des ressources liées Eclipse liées aux répertoires indiqués. La suppression incorrecte d'un projet temporaire peut entraîner la suppression de votre projet d'origine, des dossiers ou des fichiers de code source. Pour plus d'informations sur la suppression des répertoires temporaires, voir Suppression de projets temporaires créés par le paramètre -directory.
|
| -includefile | Facultatif | Ce paramètre est uniquement utilisé lorsque le paramètre -directory est présent. Il définit le chemin complet qualifié d'un fichier texte contenant une liste de fichiers de code source à analyser (un fichier par ligne). Lorsque les paramètres -directory et -includefile sont tous les deux présents, l'application de code de révision analyse uniquement les fichiers de code source indiqués dans le fichier d'inclusion et qui se trouvent dans l'un des répertoires mentionnés dans le paramètre -directory. Chaque entrée du fichier d'inclusion doit être un nom de fichier ou un chemin relatif accompagné d'un nom de fichier. L'application de révision de code recherche chacune de ces entrées dans chacun des répertoires indiqués. |
| -excludefile | Facultatif | Ce paramètre est uniquement utilisé lorsque le paramètre -directory est présent. Il définit le chemin complet qualifié d'un fichier texte contenant une liste de fichiers de code source à exclure de l'analyse (un par ligne). Lorsque les paramètres -directory et -excludefile sont tous les deux présents, l'application de révision de code exclut de l'analyse les fichiers de code source indiqués dans le fichier d'exclusion et se trouvant dans l'un des répertoires mentionnés dans le paramètre -directory. Tous les fichiers qui ne sont pas exclus sont analysés. Chaque entrée du fichier d'exclusion doit être un nom de fichier ou un chemin relatif accompagné d'un nom de fichier. L'application de révision de code recherche chacune de ces entrées dans chacun des répertoires indiqués et exclut le fichier s'il est trouvé. |
| -exportdirectory | Obligatoire | Ce paramètre définit le chemin qualifié complet du répertoire dans lequel l'application de révision de code copie ses fichiers de données de sortie XML et CSV. Ces fichiers de données peuvent être utilisés comme entrées par d'autres applications. Tous les types de fichiers de données de sortie pris en charge sont générés. Si ce paramètre est omis, aucun fichier de données de sortie n'est généré. Toutefois, l'application continue de copier les informations de sortie dans la sortie standard, si cette option est spécifiée. |
| -nosplash | Facultatif | Ce paramètre supprime l'affichage de l'écran d'accueil Eclipse. |
| -verbose | Facultatif | Ce paramètre provoque l'écriture par l'application de révision de code d'informations de sortie dans la sortie standard. Sur le système d'exploitation Windows, pour capturer des informations de sortie, vous devez non seulement indiquer le paramètre -verbose, mais aussi rediriger la sortie standard vers un fichier via la ligne de commande :
|
| >fichier_sortie | Facultatif | Utilisez cette option de redirection sur la ligne de commande pour capturer les informations de sortie de l'application dans un fichier. Sous Windows, vous devez également indiquer le paramètre -verbose pour obtenir les informations de sortie. |