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
オプション。 ロック済みレコードを検索するデータベースが含まれるデータベース セットの名前。 このオプションが指定されない場合は、デフォルトのデータベース セットが使用されます。
-database
オプション/必須。スキャンするユーザー データベース。データベース セット内に複数のユーザー データベースがある場合は、このオプションは必須です。
clearquest_login
必須。ClearQuest ユーザーのログイン名。
clearquest_password
必須。ClearQuest ユーザーのパスワード。
record_type_list
オプション。 ロックを検査するレコード タイプのリスト。各レコード タイプ名は、スペースまたはコンマで区切ることができます。
-all
オプション。 スキーマ内のすべてのレコード タイプを検査します。
-unlock
オプション。 中断されたロックが検出された場合は自動的に解放します。中断されたロックとは、-timeout オプションで指定された値より長く保持されているものを指します。このオプションでは、ログイン ユーザーにスーパー ユーザー権限が付与されている必要があります。 そうでない場合、ログイン ユーザーによって保持されたロックのみが削除されます。
-scan
オプション。 ロックを検査する間隔。値は、秒単位で示されます。
-timeout
オプション。 ロックが中断されていると判断される前に保持できる時間。 値は、秒単位で示されます。デフォルト値は、3600 秒 (1 時間) です。
-times
オプション。 スキャンする回数。デフォルトは制限なし。
-loglevel
オプション。 標準出力で出力するメッセージのレベルを指定します。 指定可能な値は、「error」、「info」または「verbose」で、段階的により詳細な情報が示されます。デフォルトは「verbose」です。

  • レコード タイプが Defect である ClearQuest データベース セットのロック済みレコードをレポートします。
    cqperl findrecordlocks.pl -dbset RecordLocking admin "" Defect   
  • ClearQuest データベース セットのユーザー データベース udb 内のロック済みレコードを 7200 秒 (2 時間) ごとにモニターし、合計 12 回スキャンします。
     cqperl findrecordlocks.pl -dbset RecordLocking admin "" Defect -scan 7200 -database udb -times 12  
  • 障害レコード タイプと要求レコード タイプの中断されたロックを、タイムアウト間隔を 5 時間に設定して、2 時間ごとにレポートします。
    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