クライアント・アプリケーションのランタイム・フラグおよびフォーマット設定フラグの構成

フラグと呼ばれるプロパティーをランチャー構成ファイルおよび Document Studio 構成ファイルに追加して、使用アプリケーションの特定のパラメーターを指定することができます。

始める前に

クライアント・アプリケーションに使用できるランタイム・フラグおよびフォーマット設定フラグのリストを調べて、このタスクを実行するのに使用するものを選択します。
表 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 認証方式を構成する場合、 有効な base_urlconsumer_key、および secret プロパティー値を、このフラグに指定された oslcServiceProviders.xml ファイルに入力する必要があります。 詳しくは、『OAuth-OSLC 認証用の oslcServiceProviders.xml ファイルの作成』をご覧になり、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.managementtrue に設定すると、ユーザーはレジストリー・キーを設定してこのメモリー制限を定義できます。そうしない場合、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 1 つの非 Unicode フォント名 またはセミコロンで区切られた複数のフォント名。

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

Rational Publishing Engine フラグ Rational Publishing Engine で使用する非 Unicode のフォントを 指定できます。指定する非 Unicode フォントは、クライアント・アプリケーションが実行されているコンピューターと同じコンピューターにインストールされている必要があります。

非 Unicode フォントは、Microsoft Word 出力では正しく生成されない場合があります。 フォントを 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 1 つのディレクトリーまたはセミコロンで区切られた 複数のディレクトリー。
例:

-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 フラグ ランチャーは、リモート発行エンジンを使用するよう構成される複合文書仕様を作成しようとするとタイムアウトになります。 クライアントのタイムアウトが早すぎる場合、タイムアウト値を増やしてください。
-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.country を含める必要があるのは、-Duser.language と組み合わせたときに参照する特定言語の翻訳が使用可能な場合のみです。
-Duser.language 言語コード

日本語の場合の例: -Duser.language=ja

標準 Java フラグ 言語の略語にこのフラグを設定して、文書生成のロケールを設定します。 言語コードの例について詳しくは、『HTML Language Code Reference』を参照してください。
-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 は、Rational Publishing Engine に固有ではない標準の Java パラメーターです。

TELELOGIC_LICENSE_FILE TELELOGIC_LICENSE_FILE システム変数に port@license_server_hostname_or_IP_address のフォームでリストされるライセンス・サーバー値。

例: 19353@LicenseServer2

Rational Publishing Engine フラグ ライセンス・サーバーのアドレスをリストする システム変数。

このタスクについて

以下のクライアント・アプリケーションの 1 つまたは両方について、ランタイム・フラグおよびフォーマット設定フラグを構成できます。

Document Studio

手順

  1. テキスト・エディターを使用して Document Studio アプリケーションの構成ファイルを開きます。 構成ファイルのデフォルトの場所は、RPE_HOME¥studio¥rpe-studio.ini です。
  2. フラグと値をファイルの終わりに追加します。 複数の値を区切るには、セミコロンを使用します。 例:
    -Dcom.ibm.rational.rpe.pdf.truetypefontdirectory=C:¥Windows¥Fonts;d:¥fontlib
  3. 変更を保存します。

ランチャー

手順

  1. テキスト・エディターを使用してランチャー・アプリケーションの構成ファイルを開きます。 構成ファイルのデフォルトの場所は、RPE_HOME¥launcher¥rpe-launcher.ini です。
  2. フラグと値をファイルの終わりに追加します。 複数の値を区切るには、セミコロンを使用します。 例:
    -Dcom.ibm.rational.rpe.pdf.truetypefontdirectory=C:¥Windows¥Fonts;d:¥fontlib
  3. 変更を保存します。

フィードバック