Skip to main content


         This documentation site is for previous versions. Visit our new documentation site for current releases.      
 

Learning about default dynamic system settings

Updated on July 8, 2022

As your Pega Platform system operates, dynamic system settings data instances can be created as needed.

Scope of dynamic system settings

You can configure dynamic system settings to apply to all nodes, a specific node, or a node type depending on the ending string. Refer to the following table to understand what terminating strings of a dynamic system setting correspond to the scope of the setting.

Terminating strings and setting scope

Terminating stringScope within Pega Platform
/defaultDefault setting. Applies this setting to all nodes.
/<nodeid>Applies this setting to the specified node.
/<nodetype>Applies this setting to the specified node type.

Default prconfig dynamic system settings

Dynamic system settings that have Pega-Engine as the owning ruleset and key names that start with prconfig are known as prconfig settings. To use prconfig DSS settings, you must configure your system as described in Configuring dynamic system settings. After creating the prconfig DSS setting, you must restart the node; if the setting specifies all nodes, then restart all nodes.

Caution: Be careful when making any updates because these settings can significantly affect the operation of your Pega Platform system.

Pega-Engine ruleset settings for prconfig

Setting namePurpose
prconfig/agent/enable/defaultEnables application agents.
prconfig/alerts/asyncdatapage/allocatedMemoryThreshold

Defines the memory threshold for queue processors, in GB. The setting is disabled by default.

Default value: -1 (disabled)

Example value: 2000

For more information, see PEGA0133 alert: Allocated memory threshold reached.

prconfig/alerts/browser/allocatedMemoryThreshold

Defines the memory threshold for browser/http requests, in GB. The setting is disabled by default.

Default value: -1 (disabled)

Example value: 2000

For more information, see PEGA0133 alert: Allocated memory threshold reached.

prconfig/alerts/jobscheduler/currentruntoolong/enabledEnables the PEGA0130 alert. Default = true.

For more information, seePEGA0130 alert: Current Job Scheduler run is taking too long.

prconfig/alerts/jobscheduler/currentruntoolong/thresholdSets the time (in seconds) after which a job scheduler is determined to have been running for too long. Default = 300.

For more information, seePEGA0130 alert: Current Job Scheduler run is taking too long.

prconfig/alerts/queueprocessor/allocatedMemoryThreshold

Defines the memory threshold for queue processors, in GB. The setting is disabled by default.

Default value: -1 (disabled)

Example value: 2000

For more information, see PEGA0133 alert: Allocated memory threshold reached.
prconfig/alerts/queueprocessor/longrunning/activity/enabledGenerates the PEGA0117 alert when such an activity runs longer than a configured threshold value.

For more information, see PEGA0117 alert: Long-running queue processor activity.

prconfig/alerts/service/allocatedMemoryThreshold

Defines the memory threshold of service requests, in GB The setting is disabled by default.

Default value: -1 (disabled)

Example value: 2000

For more information, see PEGA0117 alert: Long-running queue processor activity.

prconfig/identification/systemName/defaultSets the name of the Data-Admin-System instance for the server.
Note: The option to change the system name is not available for Pega Cloud deployments. Do not attempt to use this setting.

All Pega Platform instances (nodes) that share a single database share the same system name. By default, the system name is pega.

prconfig/initialization/displayExceptionTraceback/defaultControls the display of stack trace information in exception screens.
prconfig/initialization/explicitTempDir/defaultSpecifies the full path name to use as the temporary directory.
prconfig/initialization/persistRequestor/defaultControls whether time-put passivation is enabled. For more information, see Changing the default passivation time-out settings.
prconfig/initServices/initEmail/defaultEnables email listeners on startup, as defined in Data-Admin-Connect-EmailListener
prconfig/initServices/initFile/defaultEnables file listeners on startup, as defined in Data-Admin-Connect-FileListener
prconfig/initServices/initJMS/defaultEnables JMS listeners on startup, as defined in Data-Admin-Connect-JMSListener
prconfig/initServices/initMQ/defaultEnables MQ listeners on startup, as defined in Data-Admin-Connect-MQListener
prconfig/pradapter/loggingLevel/defaultSpecifies the level of tracing for output to the system log. This setting overwrites the setting located in the JVM properties file.
prconfig/queueprocessors/usagemonitor/alert/enabled

Generates the PEGA0134 alert when the number of items that are ready to process exceeds the threshold value for the queue processor.

For more information, see PEGA0134: Too many items in ready-to-process state.

Note: Alerts PEGA0134 and PEGA0137 use the same DSS setting.
prconfig/queueprocessors/usagemonitor/alert/enabled

Generates the PEGA0137 alert when items that are ready to be processed are not picked up by the queue processor within an expected length of time.

For more information, see PEGA0137: Ready-to-process items not picked by queue processor.

Note: Alerts PEGA0134 and PEGA0137 use the same DSS setting.
prconfig/timeout/browser/defaultThe number of seconds that requestors are idle before passivation occurs. The default value is 3,600 seconds, or 60 minutes.
prconfig/timeout/page/defaultThe number of seconds that pages are idle before passivation occurs. The default value is 900 seconds, or 15 minutes.
prconfig/timeout/thread/defaultThe number seconds that threads are idle before passivation occurs. The default value is 1800 seconds, or 30 minutes.

Default queueprocessors system settings for large message exception handling

Dynamic system settings that have Pega-Engine as the owning ruleset and key names that start with queueprocessors are known as queue processor settings for handling large message exceptions.

Note: If you change any of these queue processor settings, you do not need restart the system.

Pega-Engine ruleset settings for queueprocessors for large message exception handling

Setting namePurpose
queueprocessors/largemessagesnapshot/enabledEnables the large message handling feature in queue processing. When enabled, if the Stream Service generates the RecordTooLargeException exception, the message does not break.

The following systems default to these settings:

  • Pega Cloud environments: true (enabled)
  • On-premises or client-managed cloud environments: false (disabled)

Note: For more information on setting up this feature in an on-premises or client-managed cloud deployment, see Setting up large message handling for on-premises environments.
queueprocessors/largemessagesnapshot/repositoryThe name of the large message repository.

Default value: pegacloudfilestorage

queueprocessors/largemessagesnapshot/basepathThe basepath for the large message repository.

Default value: queueProcessors/largeMessageSnapshots

Other default dynamic system settings

The default dynamic system settings listed in the following table are narrower in scope than the Pega-Engine ruleset settings.

Other default dynamic system settings and their owning rulesets

Owning rulesetNamePurpose
Pega-RULES
Pega‑IntegrationEngineEnableRequestorPools
Note: If you change this value, you must restart your entire environment for the change to affect each component node.
  • For Pega Cloud services Services deployments, file a service request to restart.
  • For on-premises or client-managed cloud deployments, manually restart each component node of the environment.

When set to either an empty value or true, requestor pools are enabled and available for service request processing.

When set to false, requestor pools are disabled, unavailable for service request processing, and are not available to edit.

The following systems default to these settings:

  • Pega Cloud and on-premises: Enabled (no value)
  • Client-managed cloud: Disabled (false)

For more information, see Requestor pooling for services.

Pega-IntegrationEnginedisableEpochDateTimeWhen a datetime property is set to an empty value, it returns the epoch datetime (01-jan-1970) by default. Set this value to true to have the property return no value.
Pega-DesktopAllowAccessToExternalSystemUsed to control calls to external systems such as Pega Community when logging into Designer Studio. By default, this setting is set to true.
Pega-EndUserUIweblogin/mobile/enabletouchidEnables the Touch ID fingerprint recognition feature on supported iOS devices. It is used to log in to a Pega Platform mobile app, bypassing the need to manually enter user credentials each time.

Changing this setting to false disables this feature and hides the Use Touch Id check box on the Login screen. For more information, see Mobile features overview.

Pega-ProcessEnginepyEmailMaxResends See More about Email Accounts.
Pega-ProComPublicLinkURL Edit to identify a URL for directed web access, such as
http://mysystem:8081/prweb/
As a best practice, in Dev Studio, click ConfigureSystemSettingsURLs to create or update this setting. See System category — Settings page.
Pega-ProCompyUseGoalTimeForAvailabilityCalculationIf true, the assignment's goal time is compared to the assignment's start time and effort estimate to determine operator availability.

See Operator form — Completing the Work Settings tab.

Pega-ProComWorkHistoryVersionWhen set to 5.1, indicates that a one-time upgrade activity for Version 4.2 work item history instances has completed successfully.
Note: The upgrade is not necessary on systems that contain no Version 4.2 work item history instances.
Pega-RULEScompiler/defaultClassesSupports Service Java rules and other custom Java code. A list of Java classes that are added to the compile-time classpath for the compiler used to compile the generated Java. This allows service activities to call such classes.
  • For Windows systems, separate the Java classes with a colon.
  • For UNIX systems, separate the Java classes with a semicolon.

As a best practice, in Dev Studio, click ConfigureSystemSettingsCompiler to update this property.

See System category — Settings page.

Pega-RULEScompiler/defaultPathsSupports Service Java rules and other handcrafted Java code. A list of JAR files that are added to the compile-time classpath for the compiler used to compile the generated Java. This allows service activities to call the classes in external JAR files.
  • For Windows systems, separate the JAR files with a colon.
  • For UNIX systems, separate the JAR files with a colon.

As a best practice, in Dev Studio, click ConfigureSystemSettingsCompiler to update this property. See System category — Settings page.

Pega-RULESidGenerator/defaultBatchSizeSets the batch size for generating work IDs. The default value is 1000. This setting applies to all case types and to all nodes in a cluster. This setting only applies to single-tenant environments and PostgresSQL or AWS Aurora databases.
Note: When work IDs are generated and the batch size is set to 1000, performance is increased but there might be gaps in the numerical sequence of the IDs.

For example: Consecutively generated work IDs might come out as TASK-1, Task-1001, TASK-2001, TASK-2, TASK-1002, TASK-2002. As more work items are created, IDs are created that fill in the gaps between previous created IDs.

If you want fewer gaps in your work IDs, you can set the idGenerator/defaultBatchSize dynamic system setting to 100. This value causes fewer gaps in the work IDs but yields a smaller increase in performance.

To eliminate gaps in your work IDs, set the idGenerator/defaultBatchSize dynamic system setting to 1. However, a value of 1 might cause low performance.

Pega-RULESidGenerator/<case type's name followed by a hyphen>/batchSizeOverrides the idGenerator/defaultBatchSize setting for a specific case type, for example, idGenerator/WORK-/batchSize. This setting only applies to single-tenant environments and PostgresSQL or AWS Aurora databases.
Pega-RULESindexing/dataEnabledControls whether data instance indexing for full-text search is enabled.

As a best practice, in Dev Studio, click ConfigureSystemSettingsSearch to update this property.

See System category — Settings page.

Pega-RULESindexing/hostnameIn a multi-node cluster, identifies the internal node name (a hash value) of the node that supports Elasticsearch full-text indexing.

As a best practice, in Dev Studio, click ConfigureSystemSettingsSearch to update this property.

See System category — Settings page.

Pega-RULESindexing/ruleEnabledControls whether rule instance indexing is enabled. As a best practice, in Dev Studio, click ConfigureSystemSettingsSearch to update this property.

See System category — Settings page.

Pega-RULESindexing/updatetimeRecords the date and time of the last comprehensive index build.
Pega-RULESindexing/workEnabledControls whether work item indexing is enabled.

As a best practice, in Dev Studio, click ConfigureSystemSettingsSearch to update this property.

See System category — Settings page.
Pega-RULESSearchSoapURIIn a multi-node cluster, records the URI to be used in SOAP-based communications among nodes to support full-text searches.

As a best practice, in Dev Studio, click ConfigureSystemSettingsSearch to update this property.

See System category — Settings page.

Pega-RULESusage/usagetrackingenabledEnables or disables usage tracking. Initial value is true.

See How to analyze system-wide usage with the Log-Usage class.

Pega-RULESEnginepyMaxRecordsMaximum records retrieved for report definitions.

See Reporting Category — Settings Page

Pega-RULESEnginepyQueryTimeoutIntervalSee Reporting Category — Settings Page
Pega-RULESEnginepyExportMaxRecordsSee Reporting Category — Settings Page
Pega-RULESEnginepyExportQueryTimeoutSee Reporting Category — Settings Page
Pega-RULESEnginepyExportNumberOfRecordsAtATimeSpecifies the number of records exported at one time. The default setting is 5,000 records.

See Reporting Category — Settings Page

Pega-IntSvcsEmail/AddLegacyHeadersAppends old email headers to new headers if the value is true and does not append if the value is blank or not set to true.
Note: The following are the new email headers for the old headers:
  • PegaAttachmentID is the new header for X-PegaAttachmentID.
  • Email-Handle is the new header for X-PegaEmail-Handle.
  • Work-Handle is the new header for X-PegaWork-Handle.
Pega-IntSvcsFailOnAddressException

If set to true, ensures that message processing failures are caught.

If set to false, ignores processing failures related to message headers.

The default setting is true.

Pega-IntSvcsxml/removeEmptyPropertiesFromPageRemoves empty properties, including complex types, from the source page before generating the XML stream.
Pega-DecisionEnginedataflow/run/events/persistIf set to true, the data flow life cycle events are written to the database and then deleted every N days, as specified in the dataflow/run/lifecycleEventsRetentionDay dynamic system setting.

If set to false, the data flow life cycle events are not written to the database.

Note: Only set this dynamic system setting to false when too many messages are written to the database in an unstable environment.
Pega-UpdateManagerhotfixmanager.enableRevocation

Change the dynamic system setting to disable certificate revocation checking. However, disabling the setting lowers your system security.

  • If the setting value is blank or set to true (default), then revocation checking is performed.
  • If the setting value is set to false, then revocation checking is not performed.

Have a question? Get answers now.

Visit the Support Center to ask questions, engage in discussions, share ideas, and help others.

Did you find this content helpful?

Want to help us improve this content?

We'd prefer it if you saw us at our best.

Pega.com is not optimized for Internet Explorer. For the optimal experience, please use:

Close Deprecation Notice
Contact us