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 alet 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.

Example

For an example, see Pega Developer Network article PRKB-25681 Understanding the PEGA0035 alert.

	alert log, prconfig.xml file
	Understanding alerts

SysAdmin category