Permet d'afficher des informations sur les règles et les groupes de règles au sein d'un
fichier de règles.
Syntaxe
Avertissement : 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 concernant l'utilisant du script, voir
Using the Rational ClearQuest Diagnostics
utility
- 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
validatedb. 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é.
- -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.
- -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.
- -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.
- -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.
Exemples
L'exécution des commandes
describe se fait à partir de l'emplacement :
cquest–home–dir\diagnostic\.
Avertissement : Cette
commande ne peut être exécutée que depuis le script
cqdiagnostics.pl.
- Affiche des informations sur toutes les règles du fichier de règles, rules.xml
describe -rulefile cquest–home–dir\diagnostic\configuration\rules.xml
- Affiche des informations pour les règles m_fielddef_type_rule et Master_links_link_type_rule du fichier de règles, rules.xml.
describe -rulefile cquest–home–dir\diagnostic\configuration\rules.xml -rulenames m_fielddef_type_rule Master_links_link_type_rule
- Répertorie toutes les règles qui appartiennent aux groupes de règles table-existence et referential.
describe -rulefile cquest–home–dir\diagnostic\configuration\rules.xml -rulegroups table-existence referential