Visualiza información acerca de las reglas y los grupos de reglas dentro de un archivo de reglas.
Sinopsis
Atención: Este mandato únicamente puede ejecutarse desde el script
cqdiagnostics.pl. Este script contiene variables que corresponden a todos los parámetros que requiere el mandato. Edite el script para especificar el mandato
describe y los valores para las reglas o los grupos de reglas que deben describirse y para ejecutar el script. El script se instala en el directorio de instalación de Rational ClearQuest. La ubicación predeterminada es
dir-inicio-cquest\diagnostic\cqdiagnostics.pl.
Para obtener más información acerca de la utilización del script, consulte el capítulo relativo a la
utilización del programa de utilidad de diagnósticos de Rational ClearQuest
- describe –rulefile archivo_reglas [ –rulenames nombre_reglas... | –rulegroups grupos_reglas... | –allrules ]
[ –locale nombre_local ]
Descripción
El submandato
describe proporciona información acerca de las reglas y los grupos de reglas de un archivo de reglas, que utiliza el submandato
validatedb. En función de las opciones especificadas, el submandato proporciona información acerca de reglas individuales, una lista de reglas dentro de un grupo especificado o información acerca de todas las reglas de un archivo de reglas. Un archivo de reglas contiene todas las reglas y los grupos de reglas que pueden utilizarse para probar ante una base de datos. Cada regla representa una restricción utilizada para determinar la integridad de una base de datos. Un grupo de reglas es una colección de reglas. Los resultados contienen las propiedades siguientes:
- Nombre de la regla. El nombre de la regla.
- Descripción (si es aplicable). Las restricciones que la regla utiliza para validar una base de datos.
- Tipo. Una categoría para la regla que se basa en el tipo de restricción que se aplica. Ejemplos de tipos serían la existencia de tablas (Table Existence), la existencia de columnas (Column Existence)
y la verificación de valor de campo (Field Value Verification).
La descripción únicamente se escribe en la consola y no en un archivo de registro.
Opciones y argumentos
- -rulefile
- Especifica el archivo de reglas que contiene las reglas que se describirán. Esta opción escribe una lista de todas las reglas en el archivo de reglas, y una breve descripción de cada regla. Debe especificarse la vía de acceso completa al archivo de reglas.
- -rulenames
- Especifica el nombre de una o más reglas dentro del archivo de reglas que se describirá. Esta opción escribe una descripción breve de la regla en la consola. Para especificar varias reglas en un mandato, inserte un único espacio vacío entre cada nombre de regla.
- -rulegroups
- Especifica uno o más grupos de reglas dentro del archivo de reglas que se describirá.
Esta opción escribe una lista de todas las reglas en el grupo de reglas. Para especificar varios grupos de reglas en un mandato, inserte un único espacio vacío entre cada nombre de grupo de reglas.
- -allrules
- Describe todas las reglas del archivo de reglas. Esta opción escribe todas las reglas en el archivo de reglas con una breve descripción.
- -locale
- Especifica el idioma que debe utilizarse para la salida. El archivo de resultados y la consola ofrecen idiomas alternativos. El archivo de registro únicamente se escribe en inglés.
Ejemplos
Para ejecutar el mandato
describe debe estar en la ubicación siguiente:
dir-inicio-cquest\diagnostic\.
Atención: Este mandato únicamente puede ejecutarse desde el script cqdiagnostics.pl.
- Muestra información sobre todas las reglas en el archivo de reglas, rules.xml.
describe -rulefile dir-inicio-cquest\diagnostic\configuration\rules.xml
- Muestra información para las reglas, m_fielddef_type_rule y Master_links_link_type_rule en el archivo de reglas, rules.xml.
describe -rulefile dir-inicio-cquest\diagnostic\configuration\rules.xml -rulenames m_fielddef_type_rule Master_links_link_type_rule
- Enumera todas las reglas que pertenecen a grupos de reglas, table-existence y referential.
describe -rulefile dir-inicio-cquest\diagnostic\configuration\rules.xml -rulegroups table-existence referential