cqreg

在 UNIX 系統及 Linux 的 ClearQuest® 登錄中,管理資料庫集和資料庫連線資訊

用法概要

cqreg 指令位於 ClearQuest 安裝目錄的 bin 目錄中。

說明

您只能在 Windows 系統上使用 Maintenance Tool 或 Designer,來建立、刪除及移動 ClearQuest 資料庫。您可以使用 cqreg 指令來管理與 ClearQuest 資料庫集和資料庫相關聯的連線資訊,這樣您就可以在 UNIX 系統及 Linux 上存取資料庫。cqreg 指令可讓您執行下列作業:

  • 報告已登錄資料庫的相關資訊
  • 使 ClearQuest 安裝目錄與資料庫登錄目錄相關聯
  • 連接到綱目儲存庫,並在建立或刪除資料庫之後,使用 Maintenance Tool 或 Designer 重新整理資料庫登錄

您也可以在 UNIX 或 Linux 系統上執行的 ClearQuest Client 中,新增及移除資料庫連線。

選項及引數

-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,則為資料庫管理系統的系統 ID (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 指令,在新主機上登錄該資料庫集。

如果您未在 -dbset dbset_name 選項及引數中分別指定連線名稱,當您執行 cqreg drop_dbset 次指令時,會使用預設連線。

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

意見