findrecordlocks.pl

从命令行使用 findrecordlocks.pl Perl 脚本以查找记录锁并设置超时锁定。
Rational® ClearQuest® 提供以下方法来查找锁定、报告废弃的锁定以及除去废弃的锁:
  • 只报告锁定的记录。
  • 以一定的时间间隔监控锁定的记录。
  • 报告废弃的锁定。
  • 解除废弃的锁定。

该脚本安装在缺省产品安装目录中。

摘要

cqperl findrecordlocks.pl [–help ] | [–dbsetdatabase-set ] [–database user_database ] clearquest_login clearquest_password {record_type_list | –all} [–unlock] [–scan interval ] [–timeout interval ] [–timestimes] [–loglevel error | info | verbose]

选项和参数

–help
显示命令选项列表以及每个选项的简要描述。
-dbset database-set
可选。数据库集的名称,该集包含要在其中搜索锁定记录的数据库。如果未提供该选项,那么会使用缺省的 dbset。
-database
可选/必需。要扫描的用户数据库。如果 dbset 中存在多个用户数据库,那么该选项是必需的。
clearquest_login
必需。ClearQuest 用户登录名。
clearquest_password
必需。ClearQuest 用户密码。
record_type_list
可选。要对其检查锁定的记录类型的列表。记录类型名称间可由空格或逗号分隔。
-all
可选。检查模式中所有记录类型。
-unlock
可选。找到废弃的锁定时自动释放。废弃的锁定是持有时间超过 -timeout 选项所指定值的锁定。该选项要求登录用户具有超级用户特权。 否则,只会除去由登录用户持有的锁定。
-scan
可选。检查锁定的时间间隔。该值以秒为单位。
-timeout
可选。锁定被视为废弃前可持有的时间。 该值以秒为单位。缺省值为 3600 秒(1 小时)。
-times
可选。扫描次数;缺省为无限制。
-loglevel
可选。指定应在标准输出上打印的消息级别。可接受的值包括“error”、“info”或“verbose” ,这些值依次提供更多的信息。缺省值为“verbose”。

示例

  • 报告“Defect”记录类型中由 ClearQuest dbset 锁定的记录:
    cqperl findrecordlocks.pl -dbset RecordLocking admin "" Defect   
  • 每隔 7200 秒(2 小时)监控用户数据库 udb 中由 ClearQuest dbset 锁定的记录,共扫描 12 次:
     cqperl findrecordlocks.pl -dbset RecordLocking admin "" Defect -scan 7200 -database udb -times 12  
  • 使用 5 小时作为超时时间间隔,每隔 2 小时报告“Defect”和“Requirement”记录类型的废弃锁定:
    cqperl findrecordlocks.pl -dbset RecordLocking admin "" Defect,Requirement -scan 7200 -timeout 18000 -loglevel info
  • 解锁方式:每隔 2 小时查找所有记录类型中的记录锁定,并将持有时间超过 5 小时的锁定除去:
    cqperl findrecordlocks.pl -dbset RecordLocking admin "" -all -unlock -scan 7200 -timeout 18000 -loglevel verbose

反馈