Rational® Publishing Engine has
two methods for viewing process information, which you can use to
identify issues. The first method is through the Console view logs,
which display the human readable information about Rational Publishing Engine processes.
The second method is through the log files, which contains a detailed
list of changes made to the file system. Log files for both the core
and user interface processes can be used by IBM Support to help you
troubleshoot issues.
Console view
The Console view provides short
summaries of
Rational Publishing Engine processes
as they occur. For example, when you start the
Rational Publishing Engine Document
Studio, the Console view might display informational messages like
CRRPE0321I RPE License - License OK, valid for 300 more days.
CRRPE0282I RPE Document Studio started
To open
the Console view, click .
Changing the Console view character limit
In Rational Publishing Engine 1.1.1.2
and later, you can control the size of the log information kept in
the console view. By default, the maximum size is set to 100000 characters.
To
change the Console view character limit:
- Open the rpe-launcher.ini or rpe-studio.ini file.
- Locate the com.ibm.rational.rpe.console.limit parameter.
- Increase or decrease the value.
- If the value is smaller than 100000 or not set at all, no limit
is set for the logs in the Console view.
- If the value is greater than 100000, a maximum limit
size character is set in the Console view.
- Save the changes.
User interface logs
The log files store
a history of user interface related issues that occur while using Rational Publishing Engine Document
Studio and Rational Publishing Engine Launcher.
The
log files can be found in the default workspace directories for Document
Studio and Launcher:
- C:\Documents and Settings\user\Application
Data\IBM\Rational\RPE_date\Studio\workspace\.metadata
- C:\Documents and Settings\user\Application
Data\IBM\Rational\RPE_date\Launcher\workspace\.metadata
Setting the core debug mode preference
When running in Core Debug mode, detailed information
about the current element, conditions checked, and current data source
context are included in the log files. You can use the log file for
your reference or send it to IBM Software Support for additional help.
You
can activate code debug mode in either Rational Publishing Engine Launcher
or Document Studio. To activate code debug mode in both, you must
perform these steps in both applications.
To activate core debug
mode:
- Click .
- Expand RPE.
- Click Engine Preferences.
- In RPE core debug mode, click Yes.
- Click OK to save.

Core log files
The logging is controlled
in the %RPE_HOME%\config\log4j.properties file.
Note: The system variable RPE_HOME
must be defined to read the logging configuration. The default output
of the log file is RPE\RPE.log in the user home
folder: C:\Documents and Settings\user\temp\RPE\RPE.log.