Utilisez le script Perl findrecordlocks.pl à partir de la ligne de commande
pour rechercher des verrous d'enregistrements et définir des verrous avec délai d'expiration.
Rational ClearQuest propose
différents moyens de rechercher des verrous, de signaler des verrous abandonnés et de lever des verrous abandonnés :
- Renvoi des enregistrements verrouillés uniquement.
- Contrôle des enregistrement verrouillés, pendant un certain laps de temps.
- Signaler des verrous abandonnés.
- Déverrouiller des verrous abandonnés.
Ce script
est installé dans le répertoire d'installation du produit par défaut.
Syntaxe
- cqperl findrecordlocks.pl [–help ] | [–dbsetensemble_bases_de_données ]
[–database base_de_données_utilisateur ] connexion_clearquestmot_de_passe_clearquest {liste_types_enregistrement | –all} [–unlock] [–scan intervalle ]
[–timeout intervalle ] [–timesnombre de fois]
[–loglevel error | info | verbose]
Options et arguments
- –help
- Affiche la liste des options de commande et une brève description de chacune.
- -dbset ensemble_bases_de_données
- Facultatif. Nom de l'ensemble de bases de données qui contient la base
dans laquelle rechercher des enregistrements verrouillés. L'ensemble de bases de données par défaut est utilisé si l'option n'est
pas spécifiée.
- -database
- Facultatif/Obligatoire. Base de données utilisateur à analyser. Cette option est obligatoire
si l'ensemble de bases de données contient plus d'une base.
- connexion_clearquest
- Obligatoire. Nom de connexion de l'utilisateur ClearQuest.
- mot_de_passe_clearquest
- Obligatoire. Mots de passe de l'utilisateur ClearQuest.
- liste_types_enregistrement
- Facultatif. Liste de types d'enregistrement dans lesquels rechercher la présence de verrous. Chaque nom de type d'enregistrement peut être séparé par un espace ou une virgule.
- -all
- Facultatif. Vérifie tous les types d'enregistrement du schéma.
- -unlock
- Facultatif. Libère automatiquement les verrous détectés. Un verrou abandonné
est un verrou détenu depuis plus longtemps que la valeur qu'indique l'option -timeout. Cette option requiert que l'utilisateur connecté dispose de privilèges de superutilisateur.
Autrement, seuls les verrous détenus par l'utilisateur connecté seront levés.
- -scan
- Facultatif. Intervalle entre deux vérifications de présence de verrous. Sa valeur est en secondes.
- -timeout
- Facultatif. Durée pendant laquelle un verrou peut être détenu avant d'être considéré comme abandonné.
Sa valeur est en secondes. La valeur par défaut est de 3600 secondes (1 heure).
- -times
- Facultatif. Nombre de recherches ; ce nombre est illimité par défaut.
- -loglevel
- Facultatif. Indique quel niveau de message est imprimé vers la sortie standard. . Les valeurs admises sont "error", "info" ou "verbose", de l'information la plus succincte à la plus détaillée. La valeur par défaut est "verbose".
Exemples
- Pour signaler des enregistrements verrouillés d'un ensemble de bases de données ClearQuest
dont le type est "Defect" :
cqperl findrecordlocks.pl -dbset RecordLocking admin "" Defect
- Pour surveiller toutes les 7200 secondes (2 heures) des enregistrements verrouillés d'un ensemble de bases de données ClearQuest dans la base de données utilisateur udb et
effectuer 12 analyses au total :
cqperl findrecordlocks.pl -dbset RecordLocking admin "" Defect -scan 7200 -database udb -times 12
- Pour signaler des verrous abandonnés sur les types d'enregistrement Defect et Requirement toutes les 2 heures
en définissant l'intervalle timeout sur 5 heures :
cqperl findrecordlocks.pl -dbset RecordLocking admin "" Defect,Requirement -scan 7200 -timeout 18000 -loglevel info
- Mode déverrouillage : recherche toutes les 2 heures les verrous d'enregistrement dans tous les types d'enregistrement et supprime les verrous détenus depuis plus de 5 heures :
cqperl findrecordlocks.pl -dbset RecordLocking admin "" -all -unlock -scan 7200 -timeout 18000 -loglevel verbose