命令行命令

在此列示了可在命令行中使用的命令。除非另有说明,否则,命令可同时与 Rhapsody.exe 和 RhapsodyCL.exe 配合使用。

通常,下列类型的命令不能与 RhapsodyCL 配合使用:图命令、配置管理命令和用于运行宏的命令。

如果尝试将不受支持的命令与 RhapsodyCL 配合使用,那么 RhapsodyCL 的行为将取决于是否设置了 -verbose switch:

注: 对处于源控制下的项目进行更改时,在运行 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 的调用命令,其中插件名为“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

发送运行至标准输出(或通过套接字方式的相关套接字)的最后一个命令的结果。

此命令仅可与 RhapsodyCL 配合使用。

注: If 如果要以套接字方式使用 RhapsodyCL,并在单行中发送多个命令后发送 GetCommandResult 命令,那么必须通过套接字每次读取单个命令的一个结果。

-cmd=gmr

执行 generate/make/run。

-cmd=import

根据当前配置中存储的反向工程设置来导入类。此命令与在 Rational Rhapsody 中选择工具 > 反向工程的作用相同。

-cmd=make

使用当前配置构建应用程序。

make 是异步命令且必须是脚本中包含的所有命令中的最后一个命令。

因为 exit 是同步命令,所以不能将 exit(用于关闭项目并退出 Rational Rhapsody)跟在 make 命令后面;执行此操作将导致过早终止 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> 是可选参数。如果未指定,那么将使用活动组件和配置。

如果要对多个组件生成代码或对给定组件的多个配置生成代码,则必须对每个 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


反馈