Updating the Email Engine settings by using the Centralized Configuration

Specifies the date and time format that the Email Engine uses for parsing date and time strings given in the incoming mails. MMMMM dd, yyyy HH:mm:ss z is equivalent to December 21, 2009 12:08:56 PDT.

Specifies the date format that Email Engine uses for parsing date strings given in incoming mails. MMMMM dd, yyyy is equivalent to December 21, 2009.

This setting lets you specify the time format used by Email Engine for parsing time strings given in incoming mails. HH:mm:ss z is equivalent to 12:08:56 PDT.

Specifies the log level for Email Engine based on which the logs are saved in the AR System Email Error Logs form.

Valid values:

• Off (Default)
• Severe
• Warning
• Info
• Config
• Fine
• Finer
• Finest 

Specifies the number of entries to return when the Email Enginemakes a call to the AR System server.

Specifies the amount of time in milliseconds for which the Email Enginewaits before processing the next incoming message, when there are more messages residing on the Exchange Server.

Determines whether the outgoing message header should contain the Reply To field and what its value should be. getReplyToWithFromAddress is not used by default. If you want the Email Engineto use this property, you must add it to EmailDaemon.properties and set its value to true. If you add the property but do not specify a value, it is considered as false. The effect of using this property is as follows:

• If no values are provided in the Reply To Address field of the outgoing mailbox configuration form and the Reply To field of the messages form, andthe value of this property is:
  • false (or not provided)—The Reply To field is not included in the outgoing message header.
  • true—The Reply To field is included in the outgoing message header, and its value is the address in the From field of the messages form.
• If the Reply To Address field of the outgoing mailbox configuration form or the Reply To field of the messages form contains a value, the message header will contain the Reply To header value as set in the message, regardless of value of this property.

Specifies whether to wait before cancelling an attempt to connect to the mail server and generating an error. In case of an IMAP timeout, the Email Enginewaits for the timeout interval and then marks the queued message as erroneous. IMAPTimeout is not used by default. If you want the Email Engine to use this property, you must add it to EmailDaemon.properties and set its value to true. 

Specifies the duration in number of seconds to wait before cancelling an attempt to connect to the mail server and generating an error. In case of an IMAP timeout, the Email Enginewaits for this interval and then marks the queued message as an erroneous. IMAPTimeoutPeriod is not used by default. If you want the Email Engineto use this property, you must add it to EmailDaemon.properties and set its value to any positive integer. 

Specifies the default number of email messages the Email Enginereceives before the connection is closed and reopened. In Email Engine, the connection with the mail server was closed only after reading all incoming messages. Consequently, if the Email Enginecrashed or hung before the connection was closed, it was possible that messages marked for deletion would not be deleted from the mail server. This property helps you avoid that situation.

Specifies the message queue size (number of emails). The Receiver module writes messages to the queue, and the Execution module reads messages from this queue to parse and execute. The Receiver module still writes messages to the server in AR System Email Messages form, but the Execution module reads the message from the message queue instead of from the server. This reduces the traffic to the AR System and improves the performance.

Specifies the log level for Email Enginebased on which the logs are generated in the email.log file.

Valid values:

• Off
• Severe (Default)
• Warning
• Info
• Config
• Fine
• Finer
• Finest 

If you run multiple instances of the Email Engineon a single server, this property specifies which mailboxes should the Email Engineprocess. The value of this property should contain comma-separated mailbox names; the Email Engineonly processes these mailboxes. If you do not specify a value, the Email Engineprocesses all of the mailboxes configured for the server.

Specifies whether the polling interval is to be considered in minutes (as configured in AR System Email Configuration) or seconds. The Email Engineinterprets the value of this property as follows:

• true—Consider the polling interval in minutes.
• false—Consider the polling interval in seconds.

Whatever measure of unit you select applies to all configured mailboxes that are enabled.

The Email Engineinterprets the value of this property as follows:

• true—Email Enginefetches only those messages that contain the @ sign in the "from line" (from address).
• false—Email Enginefetches all the messages.

Specifies whether to wait before cancelling an attempt to connect to the mail server and generating an error. In case of an POP3 timeout, the Email Enginewaits for the timeout interval and then marks the queued message as erroneous. POP3Timeout is not used by default. If you want the Email Engineto use this property, you must add it to EmailDaemon.properties and set its value to true. When you set POP3Timeout to true, the POP3TimeoutPeriod property is used. 

Specifies the duration in number of seconds to wait before cancelling an attempt to connect to the mail server and generating an error. In case of an POP3 timeout, the Email Enginewaits for this interval and then marks the queued message as an erroneous. POP3TimeoutPeriod is not used by default. If you want the Email Engineto use this property, you must add it to EmailDaemon.properties and set its value to any positive integer.

Specifies the port number for remote method invocation (RMI). This feature is used with the EmailAdminAgent.jar file to stop, suspend, resume, or change logging level of the Email Engineat runtime.

Specifies a string if your AR System server requires authentication information before handling requests.

Specifies the language that the Email Enginemust use.

Specifies the RPC port number that the AR System server uses if you have configured a private server to be used with the Email Engine.

Specifies the TCP port number that the AR System server uses if it is not using the AR Systemportmapper.

Specifies the name of the AR System server that the Email Engineinteracts with.

Specifies whether to wait before cancelling an attempt to connect to the mail server and generating an error. In case of an SMTP timeout, the Email Enginewaits for the timeout interval and then marks the queued message as erroneous.SMTPTimeout is not used by default. If you want the Email Engineto use this property, you must add it to EmailDaemon.properties and set its value to true. If you add the property but do not specify a value, it is considered as false.

If you use these properties, BMC recommends the following SMTPTimeoutPeriod values to avoid encountering this issue:

• 40000 messages—30 seconds
• 70000 messages—60 seconds
• 100000 messages—90 seconds
  These settings can work correctly with the maximum permissible number (20) of Sender threads. However, BMC recommends using a value that is optimum for your configuration.

Specifies the duration in number of seconds to wait before cancelling an attempt to connect to the mail server and generating an error. In case of an SMTP timeout, the Email Enginewaits for this interval and then marks the queued message as an erroneous.SMTPTimeoutPeriod is not used by default. If you want the Email Engineto use this property, you must add it to EmailDaemon.properties and set its value to any positive integer (upper limit depends on the platform). If you add the property but do not specify a value, it is considered as half the polling interval that is set for outgoing mailboxes.

SMTPTimeoutPeriod is dependent on SMTPTimeout ; it works only when SMTPTimeout is set to true.

Recommendation for using the SMTP timeout properties
If you use these properties, BMC recommends the following SMTPTimeoutPeriod values to avoid encountering this issue:

• 40000 messages—30 seconds
• 70000 messages—60 seconds
• 100000 messages—90 seconds
  These settings can work correctly with the maximum permissible number (20) of Sender threads. However, BMC recommends using a value that is optimum for your configuration.

Specifies whether to store instructions and instruction parameters in the AR System server. If set to true, the Email Engineretains data in the Email Instructions and Instruction Parameters forms for troubleshooting. Then, you must delete this data explicitly. The Execution module in the Email Enginehandles both the parsing and execution of messages. There will be one message queue created for each Incoming mailbox. By default, instructions are not stored in the server.

This property is not available by default. You can add it if required. If this property is not present in EmailDaemon.properties, or if it is present but set to false, the bulk API logging mode is used. If this property is present in EmailDaemon.properties and its value set to true, then the synchronized logging mode is used.

The performance of the Email Enginemight degrade when synchronized logging is enabled, because all the Email Enginethreads are suspended while processing the synchronized logs. Synchronized logging continues to occur periodically, and control is restored to the threads only after the logging is over.

Specifies whether to retain display names that do not have email addresses associated with them in the To, CC, or BCC fields. If the setting is true, the display names are not removed from the To, CC, or BCC fields. If the setting is false, the display names are removed from the To, CC, or BCC fields.

The Email Enginechecks for email addresses associated with display names only on the User form and not on the Exchange server.

Specifies the number of users (records from the User form) to retrieve from the AR System server at one time. This setting can be used to tune the performance of the Email Engine.

Specifies the email address of the administrator. If a database transaction fails while storing an incoming message, the Email Engineforwards the original mail to this email address, so that it is retained. An example of a transaction failure could be when the database is full and cannot save anymore incoming email messages. You can specify multiple addresses separated by commas.

This property can be used only when the Email Enginedoes not capture the error out incoming email messages in the AR System Email Error Messages Form.