Previous Topic: Email Server Agent Registry ValuesNext Topic: Interactive Warning Registry Values


Automatic Registry Values

The following registry values are created automatically when you install the Exchange or Domino server agent or the IIS SMTP agent:

Agent

Available for the Exchange 2003 server agent and IIS SMTP agent only.

Type: REG_SZ

Data: Defaults to Exchange. This registry value is set to either Exchange or IIS. CA DataMinder uses this value to determine the context when processing emails.

If set to IIS, this instructs the IIS SMTP agent to check the DomainMapping registry key. This is only applicable if you are using the IIS SMTP agent to host a CA DataMinder service for use by other organizations.

AttachOriginalEmail

Type: REG_DWORD

Data: Specifies whether the original email is included as an attachment in ‘Blocked’ notification messages. Set this to zero to omit the original email from these notification messages.

If this value is not present or is set to 1, the email server agent reverts to its default behavior. That is, the original email is attached.

Note: All email attachments are removed from the original message when it is attached to a notification email.

EMailFailureMode

Type: REG_SZ

Data: This value can be set to Delete, Allow, or Mark. It defaults to Allow. This specifies how the email server agent handles event failures. If set to:

Email failures can occur when:

For details of these hub registry values, see Policy Engine Hub Key.

EnableIntegration

Type: REG_DWORD

Data: Defaults to 0 (zero). Determines whether or not the server agent processes emails. To turn on email integration (that is, to enable email processing), set this registry value to 1.

HostProcesses

Available for the Domino server agent only.

Note: We strongly recommend that any changes to this registry value are made only under the guidance of CA technical staff. See CA Technical Support.

Type: REG_SZ

Data: Defaults to nserver.exe,nhttp.exe,nsmtp.exe, nbes.exe,wgnimp.exe,wgnimpsv.exe.

This registry value enables the Domino server agent to process all Domino emails, including those originating from BlackBerry handhelds. In technical terms, this value specifies a list of hooked processes for which the Domino server agent will process Domino callbacks.

If third party email processing applications (such as antivirus or archiving products) are also running on the Domino host machine, you can use this registry value to specify a comma-separated list of process executables associated with these applications instead of the default processes listed above.

The Domino server agent will then use this amended process list to avoid contention with the third party application when processing individual emails. In effect, this registry value (usually in conjunction with the ProcessAPMStateValue registry value) ensures that the Domino server agent only processes the mail after the specified processes have modified an email for the final time.

HubFailureMode

Type: REG_SZ

Data: Defaults to Fail. This value can be set to Wait or Fail. This value instructs the hub what to do if the HighWaterMarkEventCount or HighWaterMarkMB thresholds are exceeded. If set to:

LogLevel

Type: REG_DWORD

Data: Defaults to 2. This determines the level of logging for message processing. For example, you can configure the email server agent to only log errors or warning system messages. Log entries are written to the following files:

Where <date> is the date and time when the log file was created; the file is located in CA's \data\log subfolder of the Windows All Users profile. The supported logging levels are:

1 Errors only

2 Errors and warnings

3 As 2, plus informational and status messages

Note: Setting LogLevel=3 will cause the log file to grow extremely rapidly. This level of logging is provided for testing purposes only.

LogMaxNumFiles

Type: REG_DWORD

Data: Defaults to 10. This specifies the maximum number of log files. When the maximum number of log files exists and the maximum size of the latest is reached (see above), the oldest log file is deleted to enable a new one to be created.

Note: If you are using Exchange Server 2007 or 2010, this registry value is not created automatically.

LogMaxSizeBytes

Type: REG_SZ

Data: Defaults to 1,000,000. This specifies the maximum size for each log file. When the current log file reaches its maximum size, the email server agent creates a new log file.

Note: If you are using Exchange Server 2007 or 2010, this registry value is not created automatically.

OperationMode

Applies to Exchange 2003 and IIS SMTP only.

Important! This setting must not be changed! It currently only supports a value of LocalHub. If this value is changed, you must change it back to LocalHub and restart the IIS service.

Type: REG_SZ

Data: Currently only a value of LocalHub is supported. This specifies that the email server agent passes all events to the policy engine hub on the local machine.

ReprocessClientEmails

Type: REG_SZ

Data: Create and edit this value if your CA DataMinder installation uses both the Outlook client agent and Exchange server agent, or both the Notes client agent and Domino server agent. If this value is present, the default behavior for the server agent corresponds to ‘Never’.

Never

Emails marked as already processed by the Outlook or Notes client agent are never processed a second time by the Exchange or Domino server agent.

Quarantine

Emails marked as already processed by the Outlook or Notes client agent can be processed a second time by the Exchange or Domino server agent, but only to apply a quarantine control action. This option is designed to minimize the load on the email server agent.

Always

Emails marked as already processed by the Outlook or Notes client agent are always processed a second time by the Exchange or Domino server agent.

Note: Emails generated by CA DataMinder (for example, automatic replies to blocked emails), are not processed by the Exchange or Domino server agent, even if this registry value is set to ‘Always’.

SenderAddressInclusionFilter

Type: REG_SZ

Data: Defaults to *. This value specifies a list of addresses for the email server agent to filter against. Specify a pattern for each version of user's mail (Exchange & SMTP on Exchange Server and Domino & SMTP on a Domino server).

In Active Directory, a user may have many types of email addresses. On an Exchange server the addresses might look as follows:

On a Domino server, a user might have the following:

For example, if you only want to monitor emails sent from the unipraxis.com domain, you need only set this value to ‘unipraxis’. By default, the email server agent monitors all emails passing through Exchange Server, IIS SMTP, or Domino.

If the sender’s email address does not match any item in this list, the email server agent disregards the email and allows the email to transit through Exchange Server, IIS SMTP, or Domino without intervention.

Similarly, if you want to test that integration with Exchange Server, IIS SMTP, or Domino is working correctly before you go live, you can specify the full address of a test user. This ensures that if there is problem with the integration, no other users will be affected.

Note that * and ? wildcards are supported. A * wildcard matches any sequence of zero or more digits, letters or punctuation characters. For example, a *unipraxis* filter matches spencer@sales.unipraxis.com. A ? wildcard matches any digit, letter or punctuation character, for example, spen?er matches Spencer or Spenser.

UpdateConfig

Available for the Exchange 2007 and 2010 server agents only.

Type: REG_DWORD

Data: Enables administrators to update the registry and the content of any template files while the Exchange server agent is running.

Set to 1 to force the Exchange server agent to reread the registry and the content of any template files. When the Exchange server agent has accepted the changes, it automatically resets this registry value to 0. If the Exchange server agent fails to accept the changes, it automatically sets this registry value to 2.

Important! You must update this registry value in order to update your Exchange server agent configuration.

More information:

Policy Engine Hub Key

Hosting a CA DataMinder Service for Use by Other Organizations