Gestiona información de conexión de bases de datos y conjuntos de bases de datos en el registro de ClearQuest en UNIX y en el sistema Linux
Sinopsis
El mandato cqreg se encuentra en el subdirectorio bin del directorio de instalación de ClearQuest.
- Proporciona información de conexión para las bases de datos y los conjuntos de bases de datos registrados:
- cqreg show [ -dbset nombre_conjuntobd | -all ]
[ -terse | -errors | -verbose ] [ -help ] [ -effort_only ] [ -force
] [ -home inicio_cq ] [ -version versión_cq ]
[ -cq_databases basesdatos_cq ]
- Asocia un directorio de instalación de ClearQuest con un directorio de registro de base de datos:
- cqreg initialize [ -associate ] [ directorio_registro ]
[ -help ] [ -effort_only ] [ -force ] [ -verbose | -errors ] [ -home inicio_cq ]
[ -cq_databases basesdatos_cq ]
- Registra un conjunto de bases de datos y bases de datos en el registro de ClearQuest:
- cqreg add_dbset -v/endor proveedor_bd [ -s/erver servidor_bd ]
[ -d/atabase nombre_bd ] [ [ -u/ser usuario -p/assword contraseña ] ] [ -dbset nombre_conjuntobd ] [ -co opciones_conexión ]
[ -help ] [ -effort_only ] [ -force ] [ -verbose | -errors ] [ -home inicio_cq ]
[ -cq_databases basesdatos_cq ]
- Elimina el registro de un conjunto de bases de datos y bases de datos del registro de ClearQuest:
- cqreg drop -dbset [ -dbset nombre_conjuntobd ]
[ -help ] [ -effort_only ] [ -force ] [ -verbose | -errors ] [ -home inicio_cq ]
[ -cq_databases basesdatos_cq ]
- Renueva el registro de bases de datos con la información del repositorio de esquemas:
- cqreg refresh [ -dbset nombre_conjuntobd | -all ]
[ -help ] [ -effort_only ] [ -force ] [ -verbose | -errors ] [ -home inicio_cq ]
[ -cq_databases basesdatos_cq ]
Descripción
Puede crear, suprimir y desplazar bases de datos de ClearQuest únicamente a un sistema Windows utilizando la herramienta de mantenimiento o Designer.
Se utiliza el mandato cqreg para gestionar la información de conexión asociada con bases de datos y conjuntos de bases de datos de ClearQuest para poder acceder a las bases de datos en sistemas Linux y UNIX.
El mandato cqreg permite llevar a cabo las tareas siguientes:
- Proporcionar información acerca de las bases de datos registradas
- Asociar un directorio de instalación de ClearQuest con un directorio de registro de base de datos
- Conectarse a un repositorio de esquemas y renovar el registro de bases de datos tras crear o suprimir una base de datos utilizando la herramienta de mantenimiento o el diseñador
También se pueden añadir o eliminar conexiones de base de datos desde ClearQuest Client ejecutándose en un sistema UNIX o Linux.
Opciones y argumentos
- -dbset nombre_conjuntobd
- Nombre de la conexión de la base de datos. De forma predeterminada, es la versión de ClearQuest.
- -all
- Lleva a cabo el mandato en todos los conjuntos de bases de datos y las bases de datos incluidas en los conjuntos de bases de datos.
- -verbose
- -errors
- -terse
- Controla la cantidad de salida visualizada por el mandato. Si se omite, el valor predeterminado es -errors.
- -effort_only
- Visualiza las acciones posibles del submandato sin llevarlas a cabo.
- -force
- Obliga al submandato a sustituir los archivos o los datos de registro existentes que de otro modo no se sobrescribirían.
- -home inicio_cq
- Identifica el directorio de instalación de ClearQuest.
Este valor sustituye el valor de la variable de entorno $CQ_HOME, si se ha definido.
- -version versión
- Utilice esta opción con el submandato cqreg show para identificar la versión del producto de ClearQuest a la cual se aplica el submandato. Si se omite esta opción, se utiliza la versión asociada con el release actual.
- -cq_databases basesdatos_cq
- Especifica la ubicación del directorio bajo el cual se almacenan las conexiones a las bases de datos. Este valor sustituye el valor de la variable de entorno $CQ_DATABASES, si se ha definido.
- -associate
- Utilice esta opción con el submandato cqreg initialize para asociar el directorio de instalación de ClearQuest con un directorio de registro de base de datos. Si se omite esta opción, el submandato cqreg initialize inicializa únicamente el directorio de registro, sin realizar la asociación.
- directorio_registro
- Utilice esta opción con el submandato cqreg initialize para especificar el directorio de registro. Si se omite esta opción se utiliza uno de los valores siguientes, enumerados en orden descendente:
- El valor de -cq_databases basesdatos_cq, si se ha especificado
- El valor de la variable de entorno $CQ_DATABASES, si se ha definido
- El valor predeterminado
- -v/endor proveedor_bd
- Proveedor de bases de datos. Los valores siguientes son válidos:
- -s/erver servidor
- Servidor de bases de datos.
- -d/atabase nombre_bd
- Para DB2 y SQL Server, el nombre de la base de datos utilizada para el repositorio de esquemas. Para Oracle, el identificador del sistema (SID) del sistema de gestión de bases de datos.
- -u/ser nombre_usuario
- Nombre de usuario para acceder a la base de datos.
- -p/assword contraseña
- Contraseña para acceder a la base de datos.
- -co opciones_conexión
- Opciones de conexión. Póngase en contacto con el administrador del sistema en relación con las opciones de conexión específicas de su entorno. Consulte también el tema de ayuda relativo a la administración de Rational ClearQuest en las propiedades de la base de datos del proveedor.
- -help
- Visualiza la información de uso.
Submandatos
- cqreg show
- Proporciona información de conexión para las bases de datos y los conjuntos de bases de datos registrados.
- cqreg initialize
- Asocia un directorio de instalación de ClearQuest con un directorio de registro de base de datos.
Si el archivo .Databases ya existe cuando se ejecuta el submandato cqreg initialize, no se sustituye a menos que se utilice la opción -force.
Atención: El submandato cqreg initialize se ejecuta como parte de la instalación de ClearQuest.
Ejecute este mandato únicamente si desea asociar un directorio de instalación de ClearQuest con un directorio de registro de base de datos distinto.
- cqreg add_dbset
- Registra un conjunto de bases de datos y bases de datos en el registro de ClearQuest, o actualiza la información de conexión existente.
Ejecute este submandato tras crear el repositorio de esquemas y bases de datos de usuario utilizando el diseñador.
- cqreg register
- Este submandato está obsoleto. Utilice alternativamente el mandato cqreg add_dbset.
- cqreg drop_dbset
- Elimina el registro de un conjunto de bases de datos y bases de datos del registro de ClearQuest.
Ejecute este submandato tras el desplazamiento de un conjunto de bases de datos a un host distinto para eliminar el registro del conjunto de bases de datos. Posteriormente ejecute el mandato cqreg add_dbset para registrar el conjunto de bases de datos en el host nuevo.
Si no especifica un nombre de conexión con la opción y el argumento -dbset nombre_conjuntobd, respectivamente, cuando ejecute el submandato cqreg drop_dbset,
se utilizará la conexión predeterminada.
- cqreg unregister
- Este submandato está obsoleto. Utilice alternativamente el mandato cqreg drop_dbset.
- cqreg refresh
- Renueva el registro de bases de datos con la información del repositorio de esquemas. Utilice este submandato tras utilizar la herramienta de mantenimiento o el diseñador para crear, modificar o suprimir una base de datos, o tras desplazar bases de datos y repositorios de esquemas. Si el submandato cqreg refresh no vuelve a establecer la
conexión, utilice los submandatos cqreg drop_dbset y cqreg add_dbset para
suprimir y volver a crear la información de conexión de la base de datos.
Ejemplos
- Muestra información de conexión acerca de las bases de datos y los conjuntos de bases de datos registrados:
- Renueva el registro de bases de datos para el conjunto de bases de datos UCM_dbset con la información del repositorio de esquemas:
cqreg refresh -dbset UCM_dbset
- A continuación se proporcionan ejemplos de la adición de conexiones para bases de datos Oracle, SQL
Server y DB2, respectivamente:
- Para Oracle:
cqreg add_dbset -v Oracle -s cqtest1 -d CQ1 -u admin -p admin_pwd -dbset CQ_DEV1 -co "PORT=50100"
- Para SQL Server:
cqreg add_dbset -v SQL_Server -s cqtest2 -d msitea -u admin -p pwd -dbset CQ_DEV1
- Para DB2:
cqreg add_dbset -v DB2 -s db2tcpnode -d msiteb -u admin -p pwd -dbset CQ_DEV3
- Elimine el registro del conjunto de bases de datos UCM_dbset:
cqreg drop_dbset -dbset UCM_dbset