這裡列出了可在指令行使用的指令。除非另有指示,否則指令可用於 Rhapsody.exe 和
RhapsodyCL.exe。
下列類型的指令通常不能用於 RhapsodyCL:圖表指令、配置管理指令及用於執行巨集的指令。
如果您嘗試將不受支援的指令用於 RhapsodyCL,則 RhapsodyCL 的行為取決於您是否設定了 -verbose 參數:
註: 在變更來源控制下的專案時,請先移出該專案,然後再執行
RhapsodyCL。
-cmd=addtomodel <file location> <withdescendants|withoutdescendants>
從指定的檔案位置新增至現行模型。
預設值是 <withoutdescendants>。
-cmd=arccheckout <file name> <label/revision> <locked|unlocked> <recursive|nonrecursive>
(無法用於 RhapsodyCL.exe)
從保存檔移出檔案。
如果您不想指定 <label/revision>,請使用 NULL。
-cmd=buildwithdep
使用元件的所有相依關係來建置元件。
-cmd=call <plugin> <parameters
for plugin>
呼叫其中一個 Rational® Rhapsody® 外掛程式,並將提供的參數轉遞給外掛程式。
與所有其他指令不同,這個指令的參數是作為以引號括住(在處理期間移除)的單一字串提供。字串中的第一個參數指定被呼叫的外掛程式。字串的其餘部分包含要傳送給外掛程式的任何參數。您可以將所需數目的參數傳送給外掛程式,但記住參數不能包含空格。
下列範例顯示用於執行 TestConductor 的 call 指令,其中外掛程式名稱為 "rtc":
- -cmd=call "rtc run all" 執行 TestConductor 中定義的所有測試。
例如:
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。
-cmd=checkin <unit name> <label/revision> <locked|unlocked> <recursive|nonrecursive> <description>
(無法用於
RhapsodyCL.exe)
將單元移入保存檔。如果您不想指定 <label/revision>,請使用 NULL。
例如,-cmd=checkin p1.sbs
NULL locked recursive "my description"
-cmd=checkmodel
開始「檢查模型」作業。
發出這個指令之前,請先設定現行配置。
-cmd=checkout <unit name> <label/revision> <locked|unlocked> <recursive|nonrecursive>
(無法用於 RhapsodyCL.exe)
從保存檔移出單元。如果您不想指定 <label/revision>,請使用 NULL。
-cmd=close <NoSave>
關閉已開啟的 Rational Rhapsody 模型。
依預設,Rational Rhapsody 會在關閉之前,自動儲存對模型所做的任何變更。如果您不希望產品在關閉時儲存變更,請使用 NoSave 參數。
-cmd=closediagram <diagram type><diagram
name>
(無法用於 RhapsodyCL.exe)
關閉指定的圖表。
第一個參數指定圖表類型。這個參數可採用下列其中一個值:omd、ucd、msc、collaboration 和 component。
第二個參數是模型中圖表的名稱。
Connecttoarc <archive location>
(無法用於 RhapsodyCL.exe)
連接至保存檔。<archive location> 包含完整路徑。
-cmd=creatediagram <diagram type><diagram
name>
(無法用於 RhapsodyCL.exe)
建立圖表。
第一個參數指定圖表類型。這個參數可採用下列其中一個值:omd、ucd、msc、collaboration 和 component。
第二個參數是模型中圖表的名稱。
-cmd=exit
關閉專案並結束 Rational Rhapsody。
-cmd=forceroundtrip
無論檔案的時間戳記為何,都執行來回轉換。
-cmd=generate <component> <configuration>
為指定的元件與配置產生程式碼。
<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
註: 如果您正在使用「產生自訂的程式碼」或您正在為 INTEGRITY 作業系統產生程式碼,請勿將這個指令用於
RhapsodyCL.exe。請改為將指令用於
Rhapsody.exe。
-cmd=genwithdep
使用元件的所有相依關係來產生元件。
-cmd=GetCommandResult
將執行的前一指令的結果傳送到標準輸出(或透過 Socket 模式的相關 Socket)。
這個指令只能用於 RhapsodyCL。
註: 如果您是在 Socket 模式中使用 RhapsodyCL,並在單一行中傳送數個指令之後傳送 GetCommandResult 指令,則必須從 Socket 一次讀取一個個別指令的結果。
-cmd=gmr
執行
generate/make/run。
-cmd=import
根據現行配置中儲存的反向工程設定來匯入類別。此指令的作用相等於在 Rational Rhapsody 中選取。
-cmd=make
使用現行配置來建置應用程式。
Make
是一個非同步指令,且必須是 Script 中所有指令的最後一個。
因為 exit 是一個同步指令,所以您不能在
make 指令之後再使用 exit(來關閉專案並結束 Rational Rhapsody);這樣做會讓 make 指令過早停止。
如果您計劃在 make 指令之後立即執行應用程式,請使用 -syncmake 來替代
-make。這樣便會等待 make 指令完成後再執行任何其他指令。
-cmd=new <project location> <project
name>
在指定位置建立專案,並為其指派指定的名稱。
-cmd=open <project name>
開啟指定的專案。(RhapsodyCL.exe 只能開啟專案。Rhapsody.exe 還能開啟單元。)
-cmd=opendiagram <diagram type><diagram
name>
(無法用於 RhapsodyCL.exe)
開啟指定的圖表。
第一個參數指定圖表類型。這個參數可採用下列其中一個值:omd、ucd、msc、collaboration 和 component。
第二個參數是模型中圖表的名稱。
-cmd=populatediagram <diagram type><diagram
name>
(無法用於 RhapsodyCL.exe)
移入指定的圖表。
第一個參數指定圖表類型。這個參數可採用下列其中一個值:omd、ucd、msc、collaboration 和 component。
第二個參數是模型中圖表的名稱。
-cmd=printcurrentdiagram
(無法用於 RhapsodyCL.exe)
列印開啟的圖表。
-cmd=regenerate <component> <configuration>
如果已修改模型元素,請為指定的元件與配置產生程式碼。
<component> 與 <configuration> 是選用性參數。如果未指定,就會使用作用中的元件和配置。
如果要為多個元件產生程式碼,或為給定元件的多個配置產生程式碼,必須針對每個元件/配置組合重複執行 regenerate 指令,例如:
-cmd=regenerate compA cfg1
-cmd=regenerate compA cfg2 -cmd=regenerate compB cfg1
如果要為巢狀元件重新產生程式碼,請使用語法 outerComponent::innerComponent,例如:
-cmd=regenerate def::abc DefaultConfig
註: 如果您正在使用「產生自訂的程式碼」或您正在為 INTEGRITY 作業系統產生程式碼,請勿將這個指令用於
RhapsodyCL.exe。請改為將指令用於
Rhapsody.exe。
-cmd=report <format> <name
+ location>
產生報告。
<format> 是報告格式(RTF 或 ASCII)。
會自動新增副檔名(RTF 的副檔名是 .rtf,而 ASCII 則為 .txt)。
<name
+ location> 指定報告的名稱和位置。
這些參數為選用性項目。
如果您未指定名稱,則會使用預設檔案名稱 (RhapsodyRep.rtf)。
如果您未指定位置,則會使用預設位置(專案目錄)。
發出這個指令之前,請先設定現行配置。
例如,-cmd=report RTF myReport
針對 RhapsodyCL,report 指令會使用 Rational Rhapsody 內部報告程式,且不會擷取圖表。
-cmd=roundtrip
將程式碼變更來回轉換回模型。
發出這個指令之前,請先設定現行配置。
-cmd=runexternalprogram
執行指定的外部程式。
(RhapsodyCL.exe 無法用來執行 COM 型程式。)
-cmd=save
儲存開啟的專案。可以在進行來回轉換或反向工程之類的變更之後使用。
-cmd=saveas <project name>
將專案儲存在指定的位置。<project
name> 可以包含路徑。
-cmd=setcomponent <active component
name>
設定作用中元件。
如果您要將巢狀元件設定為作用中元件,請使用語法 outerComponent::innerComponent,例如:
-cmd=setcomponent def::abc
-cmd=setconfiguration <active configuration
name>
設定作用中配置。
例如,-cmd=setconfiguration AcmeDebug
-cmd=setlog <log file>
將一般情況下傳送給輸出視窗的輸出,重新導向至指定的日誌檔。
如果參數未指定路徑,則日誌檔會放置在「現行」Rational Rhapsody 目錄中。
如果指定了日誌檔,則輸出不會傳送至標準輸出。
-cmd=setomroot <alternative OMROOT>
將變數 OMROOT 設定在新位置。這個變數指定 Rational Rhapsody 安裝的根目錄。
若要讓此指令起作用,這必須是指令行中指定的第一個選項。
-cmd=syncmake
使用現行配置來建置應用程式。
與 make 指令相反,syncmake 指令會等到 make 指令完成後再執行任何其他指令。如果您計劃在建置應用程式之後立即執行,請使用 syncmake 來替代
make。