在 Rational Team Concert for System z 指令行中工作

Rational Team Concert™ for System z® 來源控制含有一個指令行介面,可供您從指令 Shell 以靈活可 Script 化的方式,來存取重要的 Rational Team Concert for System z 來源控制作業。除了基礎 Rational Team Concert 產品中的可用指令外,Rational Team Concert for System z 還提供一些其他的指令。

Rational Team Concert for System z 來源控制指令行工具安裝在 JazzInstallDir/scmtools/eclipse 中,其中 JazzInstallDir 為安裝 Rational® Team Concert for System z 的資料夾(例如 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 中。
授權附註: 如果要執行這裡說明的作業,必須按照 Rational Team Concert for System z 2.0 版本與授權中的說明,指派「開發人員用戶端存取授權」給您。

指令語法

您可以利用下列指令,取得來源控制指令行公用程式:scm。每個 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 指令會建立一個本端工作區,供 Jazz Source Control 指令行工具使用。 您可以在本端工作區執行 Jazz Source Control 指令行工具,或利用所有需要本端工作區環境定義的 scm 次指令所共用的 -d 選項來指定它。 如果您在本端工作區執行這個次指令,便不需要指定 -d

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

在 Eclipse 工作區中,請勿利用 Jazz 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 網站中提供意見(需要登錄):在討論區中提供意見提交錯誤