findrecordlocks.pl

Utilize o script Perl findrecordlocks.pl a partir da linha de comandos para localizar bloqueios de registro e configurar os bloqueios de tempo limite.
O Rational ClearQuest fornece as seguintes maneiras de localizar bloqueios, relatar bloqueios abandonados e remover bloqueios abandonados:
  • Relatar apenas registros bloqueados.
  • Monitorar registros bloqueados em um intervalo de tempo.
  • Relatar bloqueios abandonados.
  • Desbloquear bloqueios abandonados.

Este script está instalado no diretório padrão de instalação do produto.

Sinopse

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

Opções e Argumentos

–help
Exibe uma lista de opções de comando e uma descrição resumida de cada opção.
-dbset database-set
Opcional. Nome do conjunto de bancos que contém o banco de dados para procurar os registros bloqueados. O dbset padrão será utilizado se essa opção não for fornecida.
-database
Opcional/Obrigatório. O banco de dados do usuário para varredura. Esta opção é obrigatória se houver mais de um banco de dados do usuário no dbset.
clearquest_login
Obrigatório. Nome de login do usuário do ClearQuest.
clearquest_password
Obrigatório. Senha do usuário do ClearQuest.
record_type_list
Opcional. Uma lista de tipos de registro a serem verificados pelos bloqueios. Cada nome de tipo de registro pode ser separado por espaço ou vírgula.
-all
Opcional. Verifica todos os tipos de registro no esquema.
-unlock
Opcional. Libera automaticamente os bloqueios abandonados quando localizados. Um bloqueio abandonado é aquele que foi mantido suspenso por um tempo maior do que o valor determinado pela opção -timeout. Essa opção requer que o usuário do login tenha privilégios de superusuário. Caso contrário, apenas os bloqueios suspensos pelo usuário do login serão removidos.
-scan
Opcional. O intervalo para verificar os bloqueios. O valor é em segundos.
-timeout
Opcional. O tempo que um bloqueio pode ser suspenso antes de ser considerado como abandonado. O valor é em segundos. O valor padrão é 3600 segundos (1 hora).
-times
Opcional. O número de vezes para a varredura; o padrão é ilimitado.
-loglevel
Opcional. Especifica qual nível da mensagem deve ser impresso na saída padrão. Os valores aceitos são "error", "info" ou "verbose", que fornecem informações adicionais progressivamente. O padrão é "verbose".

Exemplos

  • Relatar registros bloqueados dbset do ClearQuest no tipo de registro Defect:
    cqperl
    findrecordlocks.pl -dbset RecordLocking admin "" Defect   
  • Monitorar registros bloqueados dbset do ClearQuest a cada 7200 segundos (2 horas) no banco de dados do usuário udb e fazer varredura em um total de 12 vezes:
     cqperl
    findrecordlocks.pl -dbset RecordLocking admin "" Defect -scan 7200
    -database udb -times 12  
  • Relatar os bloqueios abandonados para os tipos de registro Defect e Requirement a cada 2 horas utilizando 5 horas como intervalo de tempo limite:
    cqperl findrecordlocks.pl -dbset RecordLocking admin ""
    Defect,Requirement -scan 7200 -timeout 18000 -loglevel info
  • Modo Desbloqueado: Procurar por bloqueios de registro em todos os tipos de registro a cada 2 horas e remover os bloqueios suspensos por mais de 5 horas:
    cqperl findrecordlocks.pl -dbset
    RecordLocking admin "" -all -unlock -scan 7200 -timeout 18000
    -loglevel verbose

Feedback