Remote flags reference for the Web Services application

You can refer to this list of remote flags and Java™ properties available to use in the Web Services application.
Select a flag from the list below and then see Configuring remote flags for the Web Services application for information on using that flag.
Table 1. Remote flags
Flag Value Description
-Dcom.ibm.rational.rpe.docgen.concurrentlimit A number

Example: -Dcom.ibm.rational.rpe.docgen.concurrentlimit=5

Set the maximum number of concurrent Rational® Publishing Engine document generation requests that can run at one time. If the limit is reached, the subsequent job requests are placed in a queue to start after the current jobs finish.
-Dcom.ibm.rational.rpe.remote.debug true, false

Example: -Dcom.ibm.rational.rpe.remote.debug=true

You can review more detailed log information for debugging document generation issues.
-Dcom.ibm.rational.rpe.remote.filestore A filepath that begins with \\

Example: -Dcom.ibm.rational.rpe.remote.filestore=\\storage\rpe\files

If you are configuring a load balancing environment, you can designate the location of the shared storage directory.
-Dcom.ibm.rational.rpe.remote.ignorelanguage true, false

Example: -Dcom.ibm.rational.rpe.remote.ignorelanguage=true

When set to true, the Web services application ignores the -Duser.country and -Duser.language flags set by the user and sets the default language specified for the server by the administrator.
-Dcom.ibm.rational.rpe.remote.javaopts Heap size

Example: -Dcom.ibm.rational.rpe.remote.javaopts=-Xmx1280m

You can increase the amount of memory allocated to generating documents by the Web Services application. The default value is -Xmx1024m.

If you are using a 32-bit Java Runtime Environment (JRE) for the Web Services application, you can adjust the heap size from 1 to 1.5 GB. If you are using a 64-bit JRE for the Web Services application, you can adjust the heap size to higher than 1.5 GB.

-Dcom.ibm.rational.rpe.remote.jre An absolute path to the Java Runtime Environment application files.

Example: -Dcom.ibm.rational.rpe.remote.jre=C:\Program Files\Java\jre7

You can specify a path to a Java Runtime Environment different from the one contained in the Rational Publishing Engine application files, which is located in %RPE_HOME%\jre.
-Dcom.ibm.rational.rpe.remote.jrearch 32 or 64 bits.

Example: -Dcom.ibm.rational.rpe.remote.jrearch=32

If Rational Publishing Engine does not detect the correct version of the Java Runtime Environment to run document generations, you can specify which version must be used.
-Dcom.ibm.rational.rpe.remote.rpecommandjar An absolute path to the rpecommand.jar file.

Example: -Dcom.ibm.rational.rpe.remote.rpecommandjar=C:\Program Files\Rational\Publishing Engine

If Rational Publishing Engine does not detect the correct the path to the rpecommand.jar, you can specify the path that must be used.
-Dcom.ibm.rational.rpe.remote.showconsole true, false.

-Dcom.ibm.rational.rpe.remote.debug must also be set to true.

Example:

-Dcom.ibm.rational.rpe.remote.showconsole=true
-Dcom.ibm.rational.rpe.remote.debug=true

Windows icon: You can open the detailed log information from com.ibm.rational.rpe.remote.debug in a separate console on Windows computers. Do not use this property if the application server is running as a Windows NT service.
-Dcom.ibm.rational.rpe.remote.workarea An absolute path that the user has write access to.

Example: -Dcom.ibm.rational.rpe.remote.workarea=C:\temp

The location where temporary files are created during document generation. If no path is specified, the temporary directory for the system is used.
-Dcom.ibm.ws.classloader.encodeResourceURLs true, false

-Dcom.ibm.rational.rpe.remote.debug must also be set to true.

Example:

-Dcom.ibm.ws.classloader.encodeResourceURLs=false
-Dcom.ibm.rational.rpe.remote.debug=true

Required only for WebSphere® Application Server 8. This flag prevents URLs from being encoded. When URLs are encoded by WebSphere Application Server 8, they cannot be read by Rational Publishing Engine.

Feedback