从命令行使用 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