cqreg

管理 UNIX 系统和 Linux 上 ClearQuest® 注册表中的数据库集和数据库连接信息

摘要

cqreg 命令位于 ClearQuest 安装目录下的 bin 目录中。

描述

只能在 Windows 系统中用 Maintenance Tool 或 Designer 创建、删除和移动 ClearQuest 数据库。cqreg 命令用于管理与 ClearQuest 数据库集和数据库关联的连接信息,以便可以访问 UNIX 系统和 Linux 上的数据库。使用 cqreg 命令可以执行以下任务:

  • 报告有关已注册数据库的信息
  • 将 ClearQuest 安装目录与数据库注册表目录关联起来
  • 连接到模式存储库,在使用 Maintenance Tool 或 Designer 创建或删除某个数据库后刷新数据库注册表

您还可从 UNIX 或 Linux 系统上运行的 ClearQuest 客户机中添加和除去数据库连接。

选项和自变量

-dbset dbset_name
数据库连接的名称。缺省情况下,为 ClearQuest 的版本。
-all
对所有数据库集以及数据库集内的所有数据库执行该命令。
-verbose
-errors
-terse
控制该命令所显示的输出数量。如果省略该选项,那么缺省情况下为 -errors
-effort_only
显示在不执行关联操作情况下子命令所执行的操作。
-force
强制子命令替换现有注册表数据或文件,否则不会覆盖这些注册表数据或文件。
-home cq_home
标识 ClearQuest 安装目录。如果设置了该值,那么它将覆盖环境变量 $CQ_HOME 的值。
-version version
cqreg show 子命令一起使用,标识该命令所针对的 ClearQuest 产品的版本。如果省略该选项,那么将使用与当前发行版关联的版本。
-cq_databases cq_databases
指定存储数据库连接的目录位置。如果设置了该值,那么它将覆盖环境变量 $CQ_DATABASES 的值。
-associate
cqreg initialize 子命令一起使用,将 ClearQuest 安装目录与数据库注册表目录关联起来。 如果省略了该选项,那么 cqreg initialize 子命令将仅初始化注册表目录,而不会建立关联。
registry_directory
cqreg initialize 子命令一起使用,指定注册表目录。如果省略该选项,那么将采用以下某个值,这些值按降序列出:
  • -cq_databases cq_databases 的值(如果指定)
  • 环境变量 $CQ_DATABASES 的值(如果已设置)
  • 缺省值
-v/endor db_vendor
数据库供应商。有效值包括:
  • Oracle
  • SQL_Server
  • DB2®
-s/erver server
数据库服务器。
-d/atabase db_name
对于 DB2 和 SQL Server,为模式存储库使用的数据库名称。对于 Oracle,为数据库管理系统的系统标识 (SID)。
-u/ser user_name
用于访问数据库的用户名。
-p/assword password
用于访问数据库的密码。
-co connect_options
连接选项。对于您的环境的连接选项,请联系系统管理员。也可参阅供应商数据库属性中的“管理 Rational® ClearQuest”帮助主题。
-help
显示用法信息。

子命令

cqreg show
报告已注册的数据库集和数据库的连接信息。
cqreg initialize
将 ClearQuest 安装目录与数据库注册表目录关联起来。如果运行 cqreg initialize 子命令时 .Databases 文件已存在,那么只有在采用 -force 选项时才会替换该文件。
注意: 在安装 ClearQuest 过程中,会运行 cqreg initialize 子命令。仅在要将 ClearQuest 安装目录与另一个数据库注册表目录关联时,才会运行该子命令。
cqreg add_dbset
在 ClearQuest 注册表中注册数据库集和数据库,或更新现有的连接信息。在用 Designer 创建模式存储库和用户数据库后,运行该子命令。
cqreg register
该子命令已废弃。而改用 cqreg add_dbset 命令。
cqreg drop_dbset
从 ClearQuest 注册表注销数据库集和数据库。在将数据库集移至另一个主机后,运行该子命令,以注销该数据库集。然后运行 cqreg add_dbset 命令,以便在新的主机上注册该数据库集。

在运行 cqreg drop_dbset 子命令时,如果没有分别用 -dbset dbset_name 选项和参数指定连接名称,那么将使用缺省连接。

cqreg unregister
该子命令已废弃。而改用 cqreg drop_dbset 命令。
cqreg refresh
用模式存储库中的信息刷新数据库注册表。在使用 Maintenance Tool 或 Designer 创建、修改或删除某个数据库之后,或在移动模式存储库和数据库之后,使用该子命令。如果 cqreg refresh 子命令没有重新建立连接,那么使用 cqreg drop_dbsetcqreg add_dbset 子命令断开数据库连接,然后重新创建数据库连接信息。

示例

  • 显示所有已注册的数据库集和数据库的连接信息:
    cqreg show -all
  • 用模式存储库中的信息刷新针对数据库集 UCM_dbset 的数据库注册表:
    cqreg refresh -dbset UCM_dbset
  • 以下分别为针对 Oracle、SQL Server 和 DB2 数据库添加连接的示例:
    对于 Oracle:
    cqreg add_dbset -v Oracle -s cqtest1 -d CQ1 -u admin -p admin_pwd -dbset CQ_DEV1 -co "PORT=50100"
    对于 SQL Server:
    cqreg add_dbset -v SQL_Server -s cqtest2 -d msitea -u admin -p pwd -dbset CQ_DEV1 
    对于 DB2:
    cqreg add_dbset -v DB2 -s db2tcpnode -d msiteb -u admin -p pwd -dbset CQ_DEV3
  • 注销数据库集 UCM_dbset
    cqreg drop_dbset -dbset UCM_dbset

反馈