cqreg

Gestiona información de conexión de bases de datos y conjuntos de bases de datos en el registro de ClearQuest en Linux y en el sistema UNIX

Sinopsis

El mandato cqreg se encuentra en el subdirectorio bin del directorio de instalación de ClearQuest.

Descripción

Puede crear, suprimir y desplazar bases de datos de ClearQuest únicamente a un sistema Windows utilizando la herramienta de mantenimiento o el diseñador. 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 Linux y en el sistema Unix. El mandatocqreg 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

Tenga en cuenta que también puede utilizar el Cliente de ClearQuest para Eclipse ejecutándose en Linux o en el sistema UNIX para añadir y eliminar conexiones de base de datos.

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:
  • Oracle
  • SQL_Server
  • DB2
-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 submandatocqreg 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:
    cqreg show -all
  • 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

Comentarios