Serviceability improvements in Rational Publishing Engine 1.3

Serviceability improvements in the 1.3 release of IBM® Rational® Publishing Engine.
See what's new:

Rational Publishing Engine debug mode

Rational Publishing Engine errors

Critical errors caused by exceptions in the output library now display the template element that caused the error in addition to the error message.

Critical errors caused by exceptions in the output library now display the template element that caused the error in addition to the error message.

JavaScript errors

If the debug mode is enabled, additional information is shown. The context information includes the element id and where the script is used as well as formatting for:
  • property
  • element content
  • condition
  • assignment
The additional information includes the value of the variables and data properties at the start of the expression as well as their values at the time when the error was produced.
JavaScript errors

Template loops

This preference setting warns the template designer of potential issues. The feature shows a warning if any query or iteration is processed consecutively for more than N repetitions, where the N threshold is defined in the preferences. You can set the loop threshold in the engine preferences:

Loop threshold preferences

For example, setting the threshold to 150 will generate the following warnings for an iteration that runs 301 times.
CRRPE1064I Processing document template 1 of 1.
CRRPE3604W The template element 4 (iteration) has been processed for 150 times which exceeds the defined threshold. This is normal for templates processing large data sets but can indicate a problem with the execution of the template otherwise.
CRRPE3604W The template element 4 (iteration) has been processed for 300 times which exceeds the defined threshold. This is normal for templates processing large data sets but can indicate a problem with the execution of the template otherwise.
CRRPE1064I 1500 publishing commands are processed. 1208 publishing commands remain to be processed.
CRRPE1064I 2709 publishing commands are processed. 0 publishing commands remain to be processed.

XML input errors

If the debug mode is enabled, Rational Publishing Engine provides additional information to help you localize the problem in the XML file. Due to how XML parsers work, Rational Publishing Engine shows the XML content read prior to the error occurring.
Note: You can also open the XML file in an XML editor or browser to discover input errors.
XML input errors

Element ID

As many of the error reports now include the ID of the element causing the error, the element ID is now a visible property and is shown in the properties page as well as in the tooltip. You can also search for a particular element ID via the Search menu.

ID field in Properties view

Rational Publishing Engine debugger


Feedback