指令行指令

這裡列出了可在指令行使用的指令。 除非另有指示,否則指令可用於 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":

例如:
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

關閉指定的圖表。

第一個參數指定圖表類型。 這個參數可採用下列其中一個值:omducdmsccollaborationcomponent

第二個參數是模型中圖表的名稱。

Connecttoarc <archive location>

(無法用於 RhapsodyCL.exe

連接至保存檔。 <archive location> 包含完整路徑。

-cmd=creatediagram <diagram type><diagram name>

(無法用於 RhapsodyCL.exe

建立圖表。

第一個參數指定圖表類型。 這個參數可採用下列其中一個值:omducdmsccollaborationcomponent

第二個參數是模型中圖表的名稱。

-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

開啟指定的圖表。

第一個參數指定圖表類型。 這個參數可採用下列其中一個值:omducdmsccollaborationcomponent

第二個參數是模型中圖表的名稱。

-cmd=populatediagram <diagram type><diagram name>

(無法用於 RhapsodyCL.exe

移入指定的圖表。

第一個參數指定圖表類型。 這個參數可採用下列其中一個值:omducdmsccollaborationcomponent

第二個參數是模型中圖表的名稱。

-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

針對 RhapsodyCLreport 指令會使用 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


意見回饋