findrecordlocks.pl

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

Retour d'informations