describe

Exibe informações sobre as regras e grupos de regras dentro de um arquivo de regras.

Sinopse

Nota: Este comando só pode ser executado a partir do script cqdiagnostics.pl. Este script contém variáveis que correspondem a todos os parâmetros requeridos pelo comando. Edite o script para especificar o comando describe e os valores para as regras ou grupos de regras a serem descritas e executar o script. O script é instalado no diretório de instalação do Rational ClearQuest. O local padrão é cquest–home–dir\diagnostic\cqdiagnostics.pl. Para obter mais informações sobre a utilização do script, consulte Utilizando o Utilitário Rational ClearQuest Diagnostics
describe –rulefile rule_file [ –rulenames rule_names... | –rulegroups rule_groups... | –allrules ] [ –locale locale_name ]

Descrição

O subcomando describe fornece informações sobre as regras e grupos de regras em um arquivo de regras, as quais são utilizadas pelo subcomando validate. Para obter informações sobre o subcomando validatedb, consulte r_validatedb.htm. Dependendo das opções especificadas, o subcomando fornece informações sobre regras individuais, uma lista de regras dentro de um grupo especificado ou informações sobre todas as regras em um arquivo de regras. Um arquivo de regras contém todas as regras e grupos de regras que podem ser utilizados para testar um banco de dados. Cada regra representa uma restrição utilizada para determinar a integridade de um banco de dados. Um grupo de regras é uma coleta de regras. Os resultados contêm as seguintes propriedades:
  • Rule Name. O nome da regra.
  • Description (se for aplicável). As restrições que a regra utiliza para validar um banco de dados.
  • Type. Uma categoria da regra que se baseia no tipo de restrições a que ela se aplica. Exemplos de Types são, Table Existence, Column Existence e Field Value Verification.
A descrição é gravada apenas no console e não é gravada em um arquivo de log.

Opções e Argumentos

-rulefile
Especifica o arquivo de regras que contém as regras a serem descritas. Esta opção grava uma lista de todas as regras do arquivo de regras e uma descrição resumida de cada uma delas. O caminho completo do arquivo de regras deve ser especificado. Consulte os Exemplos abaixo.
-rulenames
Especifica o nome de uma ou mais regras dentro do arquivo de regras a ser descrito. Esta opção grava uma descrição resumida da regra no console. Para especificar várias regras em um comando, insira um espaço vazio entre cada nome da regra. Consulte os Exemplos abaixo.
-rulegroups
Especifica um ou mais grupos de regras dentro do arquivo de regras a ser descrito. Esta opção grava uma lista de todas as regras dentro do grupo de regras. Para especificar vários grupos de regras em um comando, insira um único espaço vazio entre cada nome de grupo de regras. Consulte os Exemplos abaixo.
-allrules
Descreve todas as regras do arquivo de regras. Esta opção grava todas as regras do arquivo de regras com uma descrição resumida. Consulte os Exemplos abaixo.
-locale
Especifica qual idioma deverá ser utilizado na saída. O arquivo de resultados e o console oferecem idiomas alternativos. O arquivo de log é gravado apenas em inglês. Consulte os Exemplos abaixo.

Exemplos

Para executar os comandos describe, é necessário estar no seguinte local: cquest–home–dir\diagnostic\.
Nota: Este comando só pode ser executado a partir do script cqdiagnostics.pl.

Feedback