使用指令行

Rational Team Concert™ Source Control 含有一個指令行介面,可供您從任何指令 Shell 中,以 Script 方式來靈活存取重要的 Rational Team Concert Source Control 作業。
Rational Team Concert Source Control 指令行工具安裝在 JazzInstallDir/scmtools/eclipse 中,其中 JazzInstallDir 是安裝 Rational Team Concert 的資料夾(如 Windows® 的 C:\Program Files\IBM\TeamConcert)。 如果要在 Windows、UNIX® 系統或 Linux® 上,從指令 Shell 使用這些工具,請將 PATH 環境變數設成含有這個目錄。
註: 在部分執行 UNIX 系統或 Linux 的主機上,您也必須新增 Eclipse Java™ 執行時期環境到系統的 LD_LIBRARY_PATH 環境變數中。 請先執行下列格式的指令行:

export LD_LIBRARY_PATH=$LD_LIBRARY_PATH:JazzInstallDir/jdk/jre/bin

然後才開始使用 scm 次指令,或將指令內嵌在 Shell 啟動 Script 中。
註: 如果要改良效能,您可以使用 lscm.batlscm 來執行指令行。這種輕量型指令行版本會在您的機器上建立一項常駐程序,來減少啟動時間,並改良大部分指令的執行時間。您可能需要在這些 Script 中更換 JAVA 變數,而指向您在機器上所執行的 Java。
授權附註: 如果要執行這裡說明的作業,您必須被指派開發人員用戶端存取授權。 從 Rational Team Concert 2.0.0.1 起,貢獻者也可以部署和管理報告範本,並從這些範本來建立自己的報告。

指令語法

每個 scm 次指令的參照頁面都利用下列慣例提供了指令語法的用法概要。 有替代格式的選項用方括弧來定界。 例如:

-P  |  --password ] 

表示在這個選項中,您可以輸入 -P--password。 選用的選項用大括弧來定界。 例如:

scm load workspace -r  |  --repository-uri ] 儲存庫 URI 或暱稱
 -d  |  --dir ] workspace-path { -q  |  --quiet ] -f  |  --force ]  -c  |  --component ] name ... } component...

表示 scm load 次指令至少必須指定一個 component,接受 component 清單,-d-f-c 選項是選用的,只接受 -v-q 的其中之一。
指令採用下列一般格式:

scm {options} {subcommand {subcommand options}}

引號及其他 Shell 慣例

scm 次指令選項的引數包含空格時,必須用引號將它們括住。 在適當情況下,可以使用 Shell 萬用字元(例如:指定要移入的檔案)。

建立和儲存登入認證

雖然許多 scm 次指令都有支援單次儲存庫連線的選項,但使用 scm login 指令通常比較方便,它會將儲存庫 URI 和認證儲存起來,其他 scm 指令可以接著使用。 這個方式所儲存的認證很不容易進行探索(但並非無法探索)。 您可以利用 scm logout 指令來移除儲存認證。

本端工作區和 scm 次指令

scm loadscm share 指令會建立一個本端工作區,供 Rational Team Concert Source Control 指令行工具使用。 您可以在本端工作區執行 Rational Team Concert Source Control 指令行工具,或利用所有需要本端工作區環境定義的 scm 次指令所共用的 -d 選項來指定它。 如果您在本端工作區執行這個次指令,便不需要指定 -d

這些次指令不允許您在指令行指定儲存庫 URI。 相反地,它們會從執行指令之本端工作區(或您利用 -d 來指定的本端工作區)的相關 meta 資料衍生它。 如果您已利用 scm login 來儲存這個儲存庫的認證,次指令便不會提示輸入它們。

在 Eclipse 工作區中,請勿利用 Rational Team Concert Source Control 指令行工具來工作。

關於 UUID 和別名

許多 scm 次指令都會採用參照儲存庫物件的引數。 這些參照可能採用名稱(如工作區的名稱)、UUID(指派給每個儲存庫物件的唯一 ID)或別名的形式。 別名是短的數字字串,供您在 scm 次指令接受這類參照之處,用來參照儲存庫物件。 每當執行會傳回儲存庫物件名稱或 UUID 的次指令時,scm 指令會自動建立這些別名。 如果要使用它們,您必須輸入整個別名(它們不是整數,因此當它們存在時,您必須併入前導零)。 別名對工作區而言是唯一的。 您不能與其他團隊成員共用它們。 您無法列出它們。 它們並不長期存在(在未用別名集用完之後,任何別名都可以重複用來參照另一個物件)。

您可以在 scm 指令行上,設定 -a-u 選項來指定顯示別名、UUID,或同時顯示這兩者。y 值會顯示別名或 UUID。 n 值不顯示它們。

您也可以將 -a yes/no-u yes/no 傳遞給 scm,來顯示/隱藏別名與 UUID。例如 scm -a y -u y list ws ... 會顯示所有工作區的別名/UUID。如果換成 -a n ,則只會顯示 UUID,換成 -a n -y n 則都不顯示。

scm 次指令參照頁面中的範例會適時顯示及使用別名。

狀態旗標

若干 scm 次指令會利用表 1 中的字元來顯示檔案和資料夾的狀態。
表 1. SCM 狀態旗標
旗標 狀態
@ 變更集在作用中
! 送入資源與工作區資源版本衝突
# 送入資源與工作區資源有潛在衝突
$ 已關閉變更集
a 已新增資源
c 已修改檔案的內函或內容,或已變更目錄內容。
d 已刪除資源
m 已重新命名或移動資源
在適當情況下,會將狀態旗標組合起來。例如:

C:\local-workspaces\HelloJazz> scm history .
(1009:) #@ nobody 32424 "degauss the flux capacitor" - "most recent changes"

表示別名為 1009 的變更集在作用中 (@),且有潛在衝突 (#)。

意見

以上說明對您有幫助嗎?您可以在 Jazz.net 網站中提供意見(需要登錄):在討論區中提供意見提交錯誤