在 UNIX 系統及 Linux 的 ClearQuest® 登錄中,管理資料庫集和資料庫連線資訊
用法概要
cqreg 指令位於 ClearQuest 安裝目錄的 bin 目錄中。
- 報告已登錄資料庫集和資料庫的連線資訊:
- cqreg show [ -dbset dbset_name | -all ] [ -terse | -errors | -verbose ] [ -help ] [ -effort_only ] [ -force ] [ -home cq_home ] [ -version cq_version ] [ -cq_databases cq_databases ]
- 使 ClearQuest 安裝目錄與資料庫登錄目錄相關聯:
- cqreg initialize [ -associate ] [ registry_directory ] [ -help ] [ -effort_only ] [ -force ] [ -verbose | -errors ] [ -home cq_home ] [ -cq_databases cq_databases ]
- 在 ClearQuest 登錄中登錄資料庫集和資料庫:
- cqreg add_dbset -v/endor db_vendor [ -s/erver db_server ] [ -d/atabase db_name ] [ [ -u/ser user -p/assword password ] ] [ -dbset dbset_name ] [ -co connect_options ] [ -help ] [ -effort_only ] [ -force ] [ -verbose | -errors ] [ -home cq_home ] [ -cq_databases cq_databases ]
- 從 ClearQuest 登錄中取消登錄資料庫集和資料庫:
- cqreg drop_dbset [ -dbset dbset_name ] [ -help ] [ -effort_only ] [ -force ] [ -verbose | -errors ] [ -home cq_home ] [ -cq_databases cq_databases ]
- 以綱目儲存庫中的資訊來重新整理資料庫登錄:
- cqreg refresh [ -dbset dbset_name | -all ] [ -help ] [ -effort_only ] [ -force ] [ -verbose | -errors ] [ -home cq_home ] [ -cq_databases cq_databases ]
說明
您只能在 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
- 資料庫供應商。下列為有效值:
- -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_dbset 及 cqreg add_dbset 次指令來捨棄及重建資料庫連線資訊。
範例
- 顯示關於所有已登錄資料庫集和資料庫的連線資訊:
- 以綱目儲存庫中的資訊來重新整理資料庫集 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