cqreg

Gerencia informações de conexão do conjunto de bancos de dados e do banco de dados no registro do ClearQuest no sistema UNIX e no Linux

Sinopse

O comando cqreg está localizado no diretório bin do diretório de instalação do ClearQuest.

Descrição

É possível criar, excluir e mover bancos de dados do ClearQuest apenas em um sistema Windows usando a Ferramenta de Manutenção ou o Designer. Use o comando cqreg para gerenciar informações de conexão associadas a conjuntos de bancos de dados e bancos de dados do ClearQuest para que seja possível acessar os bancos de dados no sistema UNIX e no Linux. O comando cqreg permite executar as seguintes tarefas:

  • Relatar informações sobre os bancos de dados registrados
  • Associar um diretório de instalação do ClearQuest a um diretório de registro do banco de dados
  • Conectar-se a um repositório de esquema e atualizar o registro do banco de dados após um banco de dados ser criado ou excluído usando a Ferramenta de Manutenção ou o Designer

Também é possível incluir e remover conexões com o banco de dados do ClearQuest Client em execução em um sistema UNIX ou Linux.

Opções e Argumentos

-dbset dbset_name
Nome da conexão com o banco de dados. Por padrão, esta é a versão do ClearQuest.
-all
Executa o comando em todos os conjuntos de bancos de dados e bancos de dados no interior dos conjuntos de bancos de dados.
-verbose
-errors
-terse
Controla a quantidade de saída que o comando exibe. Se omitida, o padrão se torna -errors.
-effort_only
Exibe o que o subcomando faz sem executar a ação associada.
-force
Força o subcomando a substituir dados ou arquivos de registro existentes que, do contrário, não seriam sobrescritos.
-home cq_home
Identifica o diretório de instalação do ClearQuest. Este valor substitui o valor da variável de ambiente $CQ_HOME, se configurado.
-version version
Use com o subcomando cqreg show para identificar a versão do produto ClearQuest a que o subcomando se aplica. Se esta opção for omitida, a versão associada ao release atual será usada.
-cq_databases cq_databases
Especifica o local do diretório em que as conexões com o banco de dados são armazenadas. Este valor substitui o valor da variável de ambiente $CQ_DATABASES, se configurado.
-associate
Use com o subcomando cqreg initialize para associar o diretório de instalação do ClearQuest a um diretório de registro de banco de dados. Se esta opção for omitida, o subcomando cqreg initialize inicializa o diretório de registro apenas, sem fazer a associação.
registry_directory
Use com o subcomando cqreg initialize para especificar o diretório do registro. Se esta opção for omitida, um dos valores a seguir será usado, listados em ordem decrescente:
  • O valor de -cq_databases cq_databases, se especificado
  • O valor da variável de ambiente $CQ_DATABASES, se configurado
  • O valor-padrão
-v/endor db_vendor
Fornecedor do banco de dados. Os valores a seguir são válidos:
  • Oracle
  • SQL_Server
  • DB2
-s/erver server
Servidor do banco de dados.
-d/atabase db_name
Para DB2 e SQL Server, o nome do banco de dados usado para o repositório de esquema. Para Oracle, o System Identifier (SID) do sistema de gerenciamento de banco de dados.
-u/ser user_name
Nome de usuário para acessar o banco de dados.
-p/assword password
Senha para acessar o banco de dados.
-co connect_options
Opções de conexão. Entre em contato com o administrador do seu sistema para as opções de conexão específicas para seu ambiente. Consulte também o tópico da ajuda Administrando o Rational ClearQuest nas propriedades de banco de dados do fornecedor.
-help
Exibe informações de uso.

Subcomandos

cqreg show
Relata informações de conexão para os conjuntos de bancos de dados e bancos de dados registrados.
cqreg initialize
Associa um diretório de instalação do ClearQuest a um diretório de registro do banco de dados. Se o arquivo .Databases já existir quando o subcomando cqreg initialize for executado, ele não será substituído a menos que a opção -force seja usada.
Atenção: O subcomando cqreg initialize é executado como parte da instalação do ClearQuest. Execute esse subcomando apenas se desejar associar um diretório de instalação do ClearQuest a um diretório de registro de banco de dados diferente.
cqreg add_dbset
Registre um conjunto de bancos de dados e bancos de dados no registro do ClearQuest ou atualize informações de conexão existentes. Execute este subcomando após criar o repositório de esquema e bancos de dados do usuário usando o Designer.
cqreg register
Este subcomando está obsoleto. Use o comando cqreg add_dbset no lugar.
cqreg drop_dbset
Cancele o registro de um conjunto de bancos de dados e de bancos de dados do registro do ClearQuest. Execute este subcomando após um conjunto de bancos de dados ser movido para um host diferente para cancelar o registro do conjunto de bancos de dados. Depois, execute o comando cqreg add_dbset para registrar o conjunto de bancos de dados no novo host.

Se não for especificado um nome de conexão com a opção e argumento -dbset dbset_name, respectivamente, ao executar o subcomando cqreg drop_dbset, a conexão padrão será usada.

cqreg unregister
Este subcomando está obsoleto. Use o comando cqreg drop_dbset no lugar.
cqreg refresh
Atualiza o registro do banco de dados a partir das informações no repositório de esquema. Use este subcomando após usar a Ferramenta de Manutenção ou o Designer para criar, modificar ou excluir um banco de dados ou após mover repositórios de esquema e bancos de dados. Se o subcomando cqreg refresh não reestabelecer a conexão, use os subcomandos cqreg drop_dbset e cqreg add_dbset para descartar e recriar as informações de conexão com o banco de dados.

Exemplos

  • Mostrar as informações de conexão sobre todos os conjuntos de bancos de dados e bancos de dados registrados:
    cqreg show -all
  • Atualizar o registro de banco de dados para o conjunto de bancos de dados UCM_dbset com as informações no repositório de esquema:
    cqreg refresh -dbset UCM_dbset
  • A seguir estão exemplos de inclusão de conexões para os bancos de dados Oracle, SQL Server e 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
  • Cancelar o registro do conjunto de bancos de dados UCM_dbset:
    cqreg drop_dbset -dbset UCM_dbset

Feedback