下列類型的指令通常不能用於 RhapsodyCL:圖表指令、配置管理指令及用於執行巨集的指令。
如果您嘗試將不受支援的指令用於 RhapsodyCL,則 RhapsodyCL 的行為取決於您是否設定了 -verbose 參數:
如需 -verbose 參數的相關資訊,請參閱指令行參數
從指定的檔案位置新增至現行模型。 預設值是 <withoutdescendants>。
(無法用於 RhapsodyCL.exe)
從保存檔移出檔案。
如果您不想指定 <label/revision>,請使用 NULL。
使用元件的所有相依關係來建置元件。
呼叫其中一個 Rational® Rhapsody® 外掛程式,並將提供的參數轉遞給外掛程式。
與所有其他指令不同,這個指令的參數是作為以引號括住(在處理期間移除)的單一字串提供。 字串中的第一個參數指定被呼叫的外掛程式。 字串的其餘部分包含要傳送給外掛程式的任何參數。 您可以將所需數目的參數傳送給外掛程式,但記住參數不能包含空格。
下列範例顯示用於執行 TestConductor 的 call 指令,其中外掛程式名稱為 "rtc":
D:\RhapsodyModels\Pbx.PBX.rpt -cmd=call "rtc run all"
如需呼叫 .dll 外掛程式的相關資訊,請參閱 http://www.ibm.com/support/docview.wss?uid=swg21411451。
若要瞭解如何將 .dll 外掛程式載入至 Rational Rhapsody 專案,請參閱 http://www.ibm.com/support/docview.wss?uid=swg21411455。
(無法用於 RhapsodyCL.exe)
將單元移入保存檔。 如果您不想指定 <label/revision>,請使用 NULL。
例如,-cmd=checkin p1.sbs NULL locked recursive "my description"
開始「檢查模型」作業。
發出這個指令之前,請先設定現行配置。
(無法用於 RhapsodyCL.exe)
從保存檔移出單元。 如果您不想指定 <label/revision>,請使用 NULL。
關閉已開啟的 Rational Rhapsody 模型。 依預設,Rational Rhapsody 會在關閉之前,自動儲存對模型所做的任何變更。 如果您不希望產品在關閉時儲存變更,請使用 NoSave 參數。
(無法用於 RhapsodyCL.exe)
關閉指定的圖表。
第一個參數指定圖表類型。 這個參數可採用下列其中一個值:omd、ucd、msc、collaboration 和 component。
第二個參數是模型中圖表的名稱。
(無法用於 RhapsodyCL.exe)
連接至保存檔。 <archive location> 包含完整路徑。
(無法用於 RhapsodyCL.exe)
建立圖表。
第一個參數指定圖表類型。 這個參數可採用下列其中一個值:omd、ucd、msc、collaboration 和 component。
第二個參數是模型中圖表的名稱。
關閉專案並結束 Rational Rhapsody。
無論檔案的時間戳記為何,都執行來回轉換。
為指定的元件與配置產生程式碼。
<component> 與 <configuration> 是選用性參數。 如果未指定,就會使用作用中的元件和配置。 類似於 GUI 中的產生選項,僅會針對已修改元素產生程式碼。 若要重新產生所有程式碼,請使用 -regenerate 指令。
例如,-cmd=generate EXE Acme
如果要為多個元件產生程式碼,或為給定元件的多個配置產生程式碼,必須針對每個元件/配置組合重複執行 generate 指令,例如:
-cmd=generate compA cfg1 -cmd=generate compA cfg2 -cmd=generate compB cfg1
如果要為巢狀元件產生程式碼,請使用語法 outerComponent::innerComponent,例如:
-cmd=generate def::abc DefaultConfig
使用元件的所有相依關係來產生元件。
將執行的前一指令的結果傳送到標準輸出(或透過 Socket 模式的相關 Socket)。
這個指令只能用於 RhapsodyCL。
執行 generate/make/run。
根據現行配置中儲存的反向工程設定來匯入類別。 此指令的作用相等於在 Rational Rhapsody 中選取。
使用現行配置來建置應用程式。
Make 是一個非同步指令,且必須是 Script 中所有指令的最後一個。
因為 exit 是一個同步指令,所以您不能在 make 指令之後再使用 exit(來關閉專案並結束 Rational Rhapsody);這樣做會讓 make 指令過早停止。
如果您計劃在 make 指令之後立即執行應用程式,請使用 -syncmake 來替代 -make。 這樣便會等待 make 指令完成後再執行任何其他指令。
在指定位置建立專案,並為其指派指定的名稱。
開啟指定的專案。 (RhapsodyCL.exe 只能開啟專案。 Rhapsody.exe 還能開啟單元。)
(無法用於 RhapsodyCL.exe)
開啟指定的圖表。
第一個參數指定圖表類型。 這個參數可採用下列其中一個值:omd、ucd、msc、collaboration 和 component。
第二個參數是模型中圖表的名稱。
(無法用於 RhapsodyCL.exe)
移入指定的圖表。
第一個參數指定圖表類型。 這個參數可採用下列其中一個值:omd、ucd、msc、collaboration 和 component。
第二個參數是模型中圖表的名稱。
(無法用於 RhapsodyCL.exe)
列印開啟的圖表。
如果已修改模型元素,請為指定的元件與配置產生程式碼。
<component> 與 <configuration> 是選用性參數。 如果未指定,就會使用作用中的元件和配置。
如果要為多個元件產生程式碼,或為給定元件的多個配置產生程式碼,必須針對每個元件/配置組合重複執行 regenerate 指令,例如:
-cmd=regenerate compA cfg1 -cmd=regenerate compA cfg2 -cmd=regenerate compB cfg1
如果要為巢狀元件重新產生程式碼,請使用語法 outerComponent::innerComponent,例如:
-cmd=regenerate def::abc DefaultConfig
產生報告。
<format> 是報告格式(RTF 或 ASCII)。 會自動新增副檔名(RTF 的副檔名是 .rtf,而 ASCII 則為 .txt)。
<name + location> 指定報告的名稱和位置。 這些參數為選用性項目。
如果您未指定名稱,則會使用預設檔案名稱 (RhapsodyRep.rtf)。
如果您未指定位置,則會使用預設位置(專案目錄)。
發出這個指令之前,請先設定現行配置。
例如,-cmd=report RTF myReport
針對 RhapsodyCL,report 指令會使用 Rational Rhapsody 內部報告程式,且不會擷取圖表。
將程式碼變更來回轉換回模型。
發出這個指令之前,請先設定現行配置。
執行指定的外部程式。
(RhapsodyCL.exe 無法用來執行 COM 型程式。)
儲存開啟的專案。 可以在進行來回轉換或反向工程之類的變更之後使用。
將專案儲存在指定的位置。 <project name> 可以包含路徑。
設定作用中元件。
如果您要將巢狀元件設定為作用中元件,請使用語法 outerComponent::innerComponent,例如:
-cmd=setcomponent def::abc
設定作用中配置。
例如,-cmd=setconfiguration AcmeDebug
將一般情況下傳送給輸出視窗的輸出,重新導向至指定的日誌檔。 如果參數未指定路徑,則日誌檔會放置在「現行」Rational Rhapsody 目錄中。 如果指定了日誌檔,則輸出不會傳送至標準輸出。
將變數 OMROOT 設定在新位置。 這個變數指定 Rational Rhapsody 安裝的根目錄。
若要讓此指令起作用,這必須是指令行中指定的第一個選項。
使用現行配置來建置應用程式。
與 make 指令相反,syncmake 指令會等到 make 指令完成後再執行任何其他指令。 如果您計劃在建置應用程式之後立即執行,請使用 syncmake 來替代 make。