Table of Contents

Dynamic system settings for email integrations

Pega Platform provides dynamic system settings that you can use to modify the behavior of email processing on your system. For example, you can limit the size of an email message that your application accepts, or allow text attachments to be sent in the email body.

For more information on updating dynamic system settings, see Editing a dynamic system setting.

To ensure optimal configurations, set dynamic system settings to the recommended values. If you do not use the recommended values, Pega Predictive Diagnostic Cloud™ displays a list of dynamic system settings that do not match the recommended values.
Name Purpose
Services/EmailMaxSize Limits the maximum size in KB for an email message. Enter -1 to allow messages of any size.

This value is overridden by the Maximum email size (KB) field on the Process tab of the Email Listener data instance.

Services/EmailSuppressUnknownContentError If set to true, suppress any unknown content type errors.
Services/EmailSuppressMailAPILogging If set to true, suppress any API debugging messages.
email/timeout Connection timeout for SMTP. The recommended values are between 50000 and180000 milliseconds. The default value is 60000.
email/fetchsize Controls size of fetch in bytes if IMAP partial-fetch feature is enabled. The recommended value is 1 MB. This value typically does not need to be reset. This setting is also known as mail.imap.fetchsize.
email/partialfetch Controls whether to use the IMAP partial-fetch capability. The default value is true. Resetting this value is not recommended. This setting is also known as mail.imap.partialfetch.
email/blockResponse If true, all responses are blocked. No response will be sent. The default value is false.
email/enableTextAttachmentInEmailBody If true, text attachments can be embedded in the Email body. The default value is false.
prconfig/initServices/initEmail/default Controls whether the Email service is initialized by default at system startup. The default for the setting is true. In a multinode system, this setting allows you to control whether the Email service is available on individual nodes.
FailOnAddressException If set to true, this setting ensures that message processing failures are caught. If set to false, this setting ignores processing failures related to message headers. The default setting is false.
Did you find this content helpful?

Have a question? Get answers now.

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