About System Setting data instances
Atlas — Initial Data Instances
As your Pega 7 Platform system operates, these and other dynamic system settings instances may be created as needed. Consult the Configuration Settings Reference on the PDN for additional details on specific Dynamic System Settings instances.
Dynamic system settings that have Pega-Engine as the Owning RuleSet and key names that start with prconfig are known as prconfig settings.
Caution: Change these settings with care. These settings can have broad impact on the operation of your system. See How to create or update a prconfig setting.
Name |
Purpose |
| Pega-Engine. prconfig/agent/enable/ default |
Enables application agents. |
| Pega-Engine. prconfig/identification/ systemName/default |
Sets the name of the Data-Admin-System instance for the server. |
| Pega-Engine. prconfig/initialization/ displayExceptionTraceback/ default |
Controls the display of stack trace information in exception screens. |
| Pega-Engine. prconfig/initialization/ explicitTempDir/default |
Specifies the full path name which to be used as the work directory. |
| Pega-Engine. prconfig/initialization/ persistRequestor/default |
Sets the conditions for the system saving a user's requestor context. |
| Pega-Engine. prconfig/initServices/ initEmail/default |
Enables Email listeners on start up, as defined in Data-Admin-Connect-EmailListener |
| Pega-Engine. prconfig/initServices/ initFile/default |
Enables file listeners on start up, as defined in Data-Admin-Connect-FileListener |
| Pega-Engine. prconfig/initServices/ initJMS/default |
Enables JMS listeners on start up, as defined in Data-Admin-Connect-JMSListener |
| Pega-Engine. prconfig/initServices/ initMQ/default |
Enables MQ listeners on start up, as defined in Data-Admin-Connect-MQListener |
| Pega-Engine. prconfig/pradapter/ loggingLevel/default |
Specifies the level of tracing for output to the system log. This setting overwrites the setting located in the JVM properties file. |
These dynamic system settings have narrower scope.
Name |
Purpose |
| disableEpochDateTime/ Pega-IntegrationEngine |
When a datetime property is set and the value is empty, it will by default return the epoch datetime (01-jan-1970). Set this value to "true" to have the property return no value. |
| Pega-Desktop. AllowAccessToExternalSystem |
Used to control calls to external system such as PDN when logging into designer studio. By default, this setting is set to "true". |
| Pega-EndUserUI. weblogin/mobile/enabletouchid |
Enables Touch ID fingerprint recognition feature on supported iOS devices. It is used to log in to a Pega 7 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. See Pega Mobility. |
| Pega-ProcessEngine. pyEmailMaxResends |
|
| Pega-ProCom. ProComHelpURI |
Identifies the property containing the root URI of this Application Developer Help system. Determined during installation. As a best practice, select Designer Studio > System > Settings > Resource URLs to create or update this data instance. See System category — Settings page. |
| Pega-ProCom. PublicLinkURL |
Edit to identify a URL for directed Web access, such as http://mysystem:8081/prweb/ As a best practice, select Designer Studio > System > Settings > Resource URLs to create or update this data instance.See How to provide external assignments through directed Web access and System category — Settings page. |
| Pega-ProCom. pyUseGoalTimeFor AvailabilityCalculation |
If 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-ProCom. SystemManagementURI |
Identifies the root URI of the System Management application. Established during installation. As a best practice, select Designer Studio > System > Settings > Resource URLs to create or update this data instance. See System category — Settings page. |
| Pega-ProCom. WorkHistoryVersion |
When set to 5.1, indicates that a one-time upgrade activity for Version 4.2 work item history instances has completed successfully. The upgrade is not necessary on systems that contain no Version 4.2 work item history instances. |
| Pega-RULES. compiler/defaultClasses |
Supports Service Java rules and other handcrafted 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. As a best practice, select Designer Studio > System > Settings > Compiler to create or update this data instance. See System category — Settings page. In Version 4, this setting was stored in the pegarules.xml file. |
| Pega-RULES. compiler/defaultPaths |
Supports 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. As a best practice, select Designer Studio > System > Settings > Compiler to create or update this data instance. See System category — Settings page. See the PDN article About the Process Commander class paths.In Version 4, similar settings were stored in the pegarules.xml file. |
| Pega-RULES. indexing/dataEnabled |
Controls whether data instance indexing for full-text search is enabled. As a best practice, select Designer Studio > System > Settings > Search to create or update this data instance. See System category — Settings page. |
| Pega-RULES. indexing/hostname |
In 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, select Designer Studio > System > Settings > Search to create or update this data instance. See System category — Settings page |
| Pega-RULES. indexing/ruleEnabled |
Controls whether rule instance indexing is enabled. See As a best practice, select Designer Studio > System > Settings > Search to create or update this data instance. See System category — Settings page. |
| Pega-RULES. indexing/updatetime |
Records the date and time of the last comprehensive index build. |
| Pega-RULES. indexing/workEnabled |
Controls whether work item indexing is enabled. See As a best practice, select Designer Studio > System > Settings > Search to create or update this data instance. See System category — Settings page.. |
| Pega-RULES. SearchSoapURI |
In 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, select Designer Studio > System > Settings > Search to create or update this data instance. See System category — Settings page. |
| Pega-RULES. usage/usagetrackingenabled |
Enables or disables usage tracking. Initial value is "true". See How to analyze system-wide usage with the Log-Usage class. |
| Pega-RULESEngine pyMaxRecords |
Maximum records retrieved for report definitions. See Reporting Category — Settings Page |
| Pega-RULESEngine pyQueryTimeoutInterval |
See Reporting Category — Settings Page |
| Pega-RULESEngine pyExportMaxRecords |
See Reporting Category — Settings Page |
| Pega-RULESEngine pyExportQueryTimeout |
See Reporting Category — Settings Page |
| Pega-IntSvcs.Email/AddLegacyHeaders |
Appends 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 new email header for the old header PegaAttachmentID is X-PegaAttachmentID, for Email-Handle is X-PegaEmail-Handle, and for Work-Handle is X-PegaWork-Handle. |
About System Setting data instances
Atlas — Initial Data Instances