How to detect when a Page List property has a number of elements that exceed a threshold (PEGA0035 alert)

Alert log message

A PEGA0035 alert is generated when, during the creation of a Page List property, there are more elements then a specified threshold. A large number of embedded pages may consume substantial memory and may indicate a report design issue or a looping logic issue.

This alert has two tiers:

• If the WARN threshold is exceeded, an alert is generated. Optionally, you can configure the alert so that it also writes a traceback to the alert log. By default, the traceback option is disabled.
• If the ERROR threshold is exceeded, an alert is generated and an exception is thrown. The ERROR threshold is disabled by default.

Here is an example of a WARN-level alert message:

The number of elements in this clipboard list property has exceeded WARN level. Maximum size: 1000 Property reference: ListPage.myList Property details: myList (L!Y-)

Modifying the alert settings

You can modify the default settings in the alerts section of the prconfig.xml file, as follows:

1. Open the prconfig.xml file and update these alerts sections:

<env name = “alerts/clipboard/listsizethreshold/enabled" value="true" />

The enabled value is a boolean. To turn off the alert, change the value to "false".

<env name = “alerts/clipboard/listsizethreshold/warnsize" value="1000" />

The warnsize value is a positive integer identifying the maximum count of elements allowed in a Page List value before generating a WARN-level alert (and causing a traceback if the warntraceback value is set).

<env name = “alerts/clipboard/listsizethreshold/warntraceback" value="false" />

The warntraceback value is a Boolean that is checked when the WARN threshold is exceeded. When true, a traceback is added to the log. By default, this function is turned off. To set it, change the value to "true".

<env name = “alerts/clipboard/listsizethreshold/errorsize" value="-1" />

The errorsize value is a positive integer identifying the maximum count of elements allowed in a Page List value before generating an alert at the ERROR level and throwing an exception. This threshold is disabled by default. To enable it, enter a positive integer.

2. Stop and restart the server.

As an alternative to the prconfig.xml file, you can use Dynamic System Settings to configure your application.
See How to create or update a prconfig setting.

Example

For an example, see PDN article Understanding the PEGA0035 alert.

	alert log, prconfig.xml file
	Understanding alerts

SysAdmin category