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.
- Exibe informações para todas as regras do arquivo de regras, rules.xml
describe -rulefile cquest–home–dir\diagnostic\configuration\rules.xml
- Exibe informações para as regras, m_fielddef_type_rule e Master_links_link_type_rule no
arquivo de regras, rules.xml.
describe -rulefile cquest–home–dir\diagnostic\configuration\rules.xml -rulenames m_fielddef_type_rule Master_links_link_type_rule
- Lista todas as regras que pertencem aos grupos de regras, table-existence e referential.
describe -rulefile cquest–home–dir\diagnostic\configuration\rules.xml -rulegroups table-existence referential