运行时和格式设置标志参考

可引用供用于本地或远程文档生成的标志和 Java™ 属性的此列表。可配置这些标志,以在远程服务应用程序、Document Studio 和 Launcher 中使用。
可从下表中选择标志,然后查看下列其中一个主题,以获取有关在何处配置该标志的信息:
表 1. 运行时和格式设置标志
标志 类型 描述
-Dcom.ibm.rational.rpe.config.oslcServiceProviders 完整文件路径、UNC 路径或 HTTP 位置
示例:

-Dcom.ibm.rational.rpe.config.oslcServiceProviders=
C:\rpe\oslcServiceProviders.xml

Rational® Publishing Engine 标志 用于针对 Rational DOORS® Web Access 数据源配置 OAuth-OSLC 认证方法。必须在为此标志指定的 oslcServiceProviders.xml 文件中输入有效 base_urlconsumer_keysecret 属性值。有关更多信息,请参阅创建 oslcServiceProviders.xml 文件以进行 OAuth-OSLC 认证,并参考 Rational Publishing Engine 安装目录中的样本:RPE_HOME/config/oslcServiceProviders-sample.xml
-Dcom.ibm.rational.rpe.config.oslcServiceProviders.pwd 字符串

示例:-Dcom.ibm.rational.rpe.config.oslcServiceProviders.pwd=password

Rational Publishing Engine 标志 使用 -Dcom.ibm.rational.rpe.config.oslcServiceProviders 标志执行 OAuth-OSLC 认证所需的密码。
-Dcom.ibm.rational.rpe.config.oslcServiceProviders.usr 字符串

示例:-Dcom.ibm.rational.rpe.config.oslcServiceProviders.usr=user

Rational Publishing Engine 标志 使用 -Dcom.ibm.rational.rpe.config.oslcServiceProviders 标志执行 OAuth-OSLC 认证所需的用户名。
-Dcom.ibm.rational.rpe.disablecommands truefalse

示例:-Dcom.ibm.rational.rpe.disablecommands=true

Rational Publishing Engine 标志 要提高安全性,可将此标志设置为禁止远程服务应用程序执行任何前命令和后命令。
-Dcom.ibm.rational.rpe.mc.maxerrorcount 数字

缺省值:3

示例:-Dcom.ibm.rational.rpe.mc.maxerrorcount=

Rational Publishing Engine 标志 客户机尝试与“监视和控制”组件连接(以列示文档生成作业)的次数。通常,如果在连续 6 次尝试之后仍无法与服务器联系,那么服务器可能已关闭并且必须由管理员重新启动。
-Dcom.ibm.rational.rpe.console.limit 字符数

缺省值:100000 个字符

示例:-Dcom.ibm.rational.rpe.console.limit=90000

Rational Publishing Engine 标志 可以控制“控制台”视图中保留的日志信息的大小。
-Dcom.ibm.rational.rpe.doors.data 要传递至 Rational DOORS 命令行的数据参数

示例:-Dcom.ibm.rational.rpe.doors.data=36677@localhost

Rational Publishing Engine 标志 可包括此标志以识别 Rational DOORS 数据库,以便 Rational Publishing Engine 不必对它进行识别。当 Rational DOORS 稳定或者在不允许运行 reg.exe 命令的计算机上设置了文档生成时,设置此值会提高性能。当配置了此标志时,它会覆盖对文档规范中的 doors_param 属性指定的值。可将此标志指定为系统变量或 Java 运行时变量。Java 运行时变量优先于系统变量。

当配置此标志时,必须将 new_instance 属性设置为 true

-Dcom.ibm.rational.rpe.doors.flags Rational DOORS 命令行选项

示例:-Dcom.ibm.rational.rpe.doors.flags=“-addins file path

Rational Publishing Engine 标志 可对 Rational DOORS 指定命令行选项。可将此标志指定为系统变量或 Java 运行时变量。Java 运行时变量优先于系统变量。
-Dcom.ibm.rational.rpe.doors.home 指向 Rational DOORS 可执行文件的路径
示例:

-Dcom.ibm.rational.rpe.doors.home=
C:\Program Files (x86)\IBM\Rational\DOORS\9.5\bin\doors.exe

Rational Publishing Engine 标志 可包括此标志以识别 Rational DOORS 版本,以便 Rational Publishing Engine 不必对它进行识别。当 Rational DOORS 稳定或者在不允许运行 reg.exe 的虚拟机上设置了您的文档生成时,设置此值可提高性能。当配置了此标志时,它会覆盖对文档规范中的 doors_home 属性指定的值。可将此标志指定为系统变量或 Java 运行时变量。Java 运行时变量优先于系统变量。

当配置此标志时,必须将 new_instance 属性设置为 true

-Dcom.ibm.rational.rpe.dxl.enable.memory.management truefalse

缺省值:false

示例:-Dcom.ibm.rational.rpe.dxl.enable.memory.management=true

Rational Publishing Engine 标志

如果 Rational DOORS 模块已链接至其他模块,那么当文档生成时,Rational Publishing Engine 必须在后台打开这些所链接模块。此外,当使用布局 DXL 代码时,会在后台打开模块,直到 DXL 完成。

在这两种情况下,都正使用 Rational DOORS 客户机内存来在后台打开和关闭这些模块。可配置注册表键,以便当达到内存限制时,后台进程会在它们完成对当前对象的读取时关闭,并且仅在必要时,才会再次重新打开该对象。

-Dcom.ibm.rational.rpe.dxl.enable.memory.management 设置为 true 时,用户可设置注册表键以定义此内存限制,否则,会使用 DXL 代码中设置的缺省内存限制 2GB。请参阅对 Rational DOORS 文档生成进行故障诊断,以获取有关注册表键的更多信息。

缺省值为 false,并且注册表键对文档生成过程没有影响。

-Dcom.ibm.rational.rpe.enable.surrogate.char.processing truefalse

缺省值:false

示例:-Dcom.ibm.rational.rpe.enable.surrogate.char.processing=true

Rational Publishing Engine 标志 在 Microsoft Word 和 PDF 输出中,Unicode 代理(通常是表示亚洲语言的字符)将从输出中移除。在文档生成期间,您可以启用 -Dcom.ibm.rational.rpe.enable.surrogate.char.processing 来正确处理这些字符,以将其按预期包括在输出中。
-Dcom.ibm.rational.rpe.nonunicodefonts 一个非 Unicode 字体名称或用分号分隔的若干字体名称。

示例:-Dcom.ibm.rational.rpe.nonunicodefonts=Akshar

Rational Publishing Engine 标志 可指定要在 Rational Publishing Engine 中使用的非 Unicode 字体。您指定的非 Unicode 字体必须安装在正运行客户机应用程序的计算机上。

在 Microsoft Word 输出中,不会始终正确生成非 Unicode 字体。请将字体设置为 Arial Unicode MS 或任何其他能够呈示此字符的字体,然后输出会正确生成。

-Dcom.ibm.rational.rpe.output.default 临时目录

缺省值:TEMP\rpe\output

示例:-Dcom.ibm.rational.rpe.output.default=C:\RPE\output

Rational Publishing Engine 标志 可将临时目录从缺省位置更改为其他位置。 可将此标志指定为系统变量或 Java 运行时变量。Java 运行时变量优先于系统变量。
-Dcom.ibm.rational.rpe.pdf.truetypefontdirectory 一个目录或用分号分隔的若干目录。
示例:

-Dcom.ibm.rational.rpe.pdf.truetypefontdirectory=
C:\Windows\Fonts;d:\fontlib

Rational Publishing Engine 标志 如果系统在非缺省目录中安装了额外字体,那么可指定这些字体目录。
-Dcom.ibm.rational.rpe.rpews.scheduler.pwd 要向报告计划程序认证的用户密码。

示例:-Dcom.ibm.rational.rpe.rpews.scheduler.pwd=password

Rational Publishing Engine 标志 要向远程服务应用程序的报告计划程序组件进行认证,请使用密码配置此标志。
-Dcom.ibm.rational.rpe.rpews.scheduler.url 报告计划程序的 URL。
示例:

-Dcom.ibm.rational.rpe.rpews.scheduler.url=
http://server:port/rpews/scheduler

Rational Publishing Engine 标志 要向远程服务应用程序的报告计划程序组件进行认证,请使用 URL 配置此标志。
-Dcom.ibm.rational.rpe.rpews.scheduler.usr 要向报告计划程序认证的用户名。

示例:-Dcom.ibm.rational.rpe.rpews.scheduler.usr=user

Rational Publishing Engine 标志 要向远程服务应用程序的报告计划程序组件进行认证,请使用用户名配置此标志。
-Dcom.ibm.rational.rpe.wstimeout 时间(以毫秒计)

缺省值:30000 毫秒

示例:-Dcom.ibm.rational.rpe.wstimeout=35000

Rational Publishing Engine 标志 创建配置为使用远程发布引擎的复杂文档规范时,Launcher 超时。如果发现客户机太早超时,请增大超时值。
-Dcom.ibm.rational.rpews.pwd 要向远程服务认证的用户密码。

示例:-Dcom.ibm.rational.rpews.pwd=password

Rational Publishing Engine 标志 要向远程服务应用程序进行认证,请使用密码配置此标志。
-Dcom.ibm.rational.rpews.url URL
示例:

-Dcom.ibm.rational.rpews.url=
http://server:port/rpews/

Rational Publishing Engine 标志 用于连接到远程服务应用程序的 URL。如果管理员不允许用户更改该位置,那么此 URL 不可编辑。
-Dcom.ibm.rational.rpews.usr 要向远程服务认证的用户名。

示例:-Dcom.ibm.rational.rpews.usr=user

Rational Publishing Engine 标志 要向远程服务应用程序进行认证,请使用用户名配置此标志。
-Dosgi.configuration.area 文件路径
示例:

-Dosgi.configuration.area=@user.home/Application
Data/IBM/Rational/RPE_qualifier_date/Launcher/workspace/

标准 Java 标志 要更改您的文档生成所在的缺省输出位置,您可以更改此参数的文件路径。为 -Dosgi.instance.area-Dosgi.configuration.area 参数指定相同值。
-Dosgi.instance.area 文件路径
示例:

-Dosgi.instance.area=@user.home/Application
Data/IBM/Rational/RPE_qualifier_date/Launcher/workspace/

标准 Java 标志 要更改您的文档生成所在的缺省输出位置,您可以更改此参数的文件路径。为 -Dosgi.configuration.area-Dosgi.instance.area 参数指定相同值。
-Duser.country 国家或地区代码
针对巴西葡萄牙语的示例:

-Duser.country=BR -Duser.language=pt

标准 Java 标志 将此标志设置为对应于您的语言代码的国家或地区的缩写,以设置您的文档生成的语言环境。当与 -Duser.language 结合使用时,如果提供了它所引用的特定语言的翻译版本,那么只需要包括 -Duser.country
-Duser.language 语言代码

针对日语的示例:-Duser.language=ja

标准 Java 标志 将此标志设置为某个语言的缩写,以设置您的文档生成的语言环境。有关语言代码的更多示例,请参阅 HTML 语言代码引用
-Duser.timezone GMT+offset

示例:-Duser.timezone=GMT+02:00

标准 Java 标志 Rational Publishing Engine 会将日期和时间转换为安装了 Rational Publishing Engine 的计算机的时区,而不是转换为正在远程生成文档的服务器的时区。要指定将作为服务器的日期和时间,请输入 GMT 以及服务器位置相对于格林威治标准时间的偏移量(以小时数计)。
–Xmx<value>m Java 堆设置

示例:–Xmx512m

IBM® Java 运行时环境标志 减小产品配置文件中此参数的值以使 Rational Publishing Engine 能够在虚拟机上启动。

增加该值以提高在其他环境(而不是虚拟机)中生成大型文档时的性能。

–Xmx 是标准 Java 参数,不是 Rational Publishing Engine 特有的参数。

TELELOGIC_LICENSE_FILE TELELOGIC_LICENSE_FILE 系统变量中列出的许可证服务器值(格式为 port@license_server_hostname_or_IP_address)。

示例:19353@LicenseServer2

Rational Publishing Engine 标志 用于列出许可证服务器的地址的系统变量。

反馈