describe

Permet d'afficher des informations sur les règles et les groupes de règles au sein d'un fichier de règles.

Syntaxe

Remarque : Cette commande ne peut être exécutée que depuis le script cqdiagnostics.pl. Ce script contient des variables correspondant à tous les paramètres nécessaires à la commande. Editez le script pour indiquer la commande describe et les valeurs des règles ou des groupes de règles à décrire, puis exécutez le script. Le script est installé dans le répertoire d'installation de Rational ClearQuest. L'emplacement par défaut est cquest–home–dir\diagnostic\cqdiagnostics.pl. Pour plus d'informations sur l'utilisation du script, voir Utilisation de l'utilitaire Rational ClearQuest Diagnostics
describe –rulefile fichier_règles [ –rulenames nom_règles... | –rulegroups groupes_règles... | –allrules ] [–locale nom_envlocal ]

Description

La sous-commande describe fournit des informations sur les règles et groupes de règles d'un fichier de règles, qui sont utilisées par la sous-commande validate. Pour plus d'informations sur la sous-commande validatedb, voir r_validatedb.htm. Suivant les options utilisées, la sous-commande donne des informations sur des règles individuelles, sur une liste de règles dans un groupe donné ou sur toutes les règles d'un fichier de règles. Un fichier de règles contient toutes les règles et tous les groupes de règles pouvant être utilisés pour effectuer des tests sur une base de données. Chaque règle représente une contrainte utilisée pour déterminer l'intégrité d'une base de données. Un groupe de règles est une collection de règles. Les résultats contiennent les propriétés suivantes :
  • Nom de règle. Nom de la règle.
  • Description (le cas échéant). Contraintes qu'utilise la règle pour contrôler la validité d'une base de données.
  • Type. Catégorie de la règle en fonction des types de contraintes appliquées. Les types peuvent être, par exemple, Table Existence, Column Existence et Field Value Verification.
La description est consignée uniquement sur la console, pas dans un fichier journal.

Options et arguments

-rulefile
Désigne le fichier de règles contenant les règles à décrire. Cette option consigne la liste de toutes les règles du fichier de règles, ainsi qu'une brève description de chacune. Le chemin d'accès complet au fichier de règles doit être indiqué. Voir Exemples ci-après.
-rulenames
Indique le nom d'une ou de plusieurs règles du fichier de règles à décrire. Cette option permet d'écrire une brève description de la règle sur la console. Pour définir plusieurs règles dans une même commande, insérez un espace unique entre chaque nom de règle. Voir Exemples ci-après.
-rulegroups
Indique un ou plusieurs groupes de règles du fichier de règles à décrire. Cette option permet d'écrire la liste de toutes les règles du groupe de règles. Pour définir plusieurs groupes de règles dans une même commande, insérez un espace unique entre chaque nom de groupe de règles. Voir Exemples ci-après.
-allrules
Décrit toutes les règles du fichier de règles. Cette option permet de consigner toutes les règles dans le fichier de règles ainsi qu'une brève description. Voir Exemples ci-après.
-locale
Indique la langue utilisée dans la sortie. Le fichier de résultats et la console proposent d'autres langues. Le fichier journal est quant à lui toujours écrit en anglais. Voir Exemples ci-après.

Exemples

Pour exécuter les commandes describe, vous devez vous trouver à l'emplacement suivant : C:\Programmes\Rational\ClearQuest\diagnostic\.
Remarque : Cette commande ne peut être exécutée que depuis le script cqdiagnostics.pl.

Retour d'informations