Previous Topic: Prevent Automatic Startup: DisableAutoStart_Client.mstNext Topic: Prevent Consoles being Installed: HideConsole_Client.mst


Configure Outlook Endpoint Agent: EmailClientOptions.mst

For command line, Group Policy or SMS installations, you can create registry values to control the behavior of the Outlook client agent. Typically you use these settings in order to alleviate email processing delays.

Follow these steps:

  1. Find the EmailClientOptions.vbs script in the \Support folder of your CA DataMinder distribution media.
  2. Run the script.

    Note: For command syntax details, see the Support Tools section. You can configure any or all of the registry values described above.

    It creates the EmailClientOptions_Client.mst (or EmailClientOptions_Client_x64.mst) transform.

  3. Copy the transform into the folder containing your administrative installation source image.

The transform creates new values in the following registry key:

HKEY_LOCAL_MACHINE\Software\ComputerAssociates\CA DataMinder\CurrentVersion\EMail

Or for 32-bit Outlook client running on a 64-bit OS:

HKEY_LOCAL_MACHINE\Software\WOW6432Node\ComputerAssociates\CA DataMinder\CurrentVersion\EMail

Note: This script requires Windows Script Host 5.6 or later. You can download version 5.6 from the Microsoft Web site: http://msdn.microsoft.com/scripting.

You configure the script to create and specify the following registry values:

NeverPutPDLsInRecipientsList

Type: REG_DWORD

Data: Specifies that CA DataMinder should prevent unexpanded (or only partially expanded) PDLs from being saved as email recipients. This prevents control triggers from activating inadvertently.

Default: zero

MaxNumExpandedRecipients

Type: REG_DWORD

Data: Specifies the maximum number of recipients extracted from distribution lists in a single email. This setting can alleviate email processing delays.

Default: zero, CA DataMinder can extract an unlimited number of recipients.

DontProcessReceived

Note: Applies to incoming emails only.

Type: REG_DWORD

Data: Specifies that CA DataMinder does not process incoming emails until the recipient attempts to read them.

Default: zero, CA DataMinder processes incoming emails as soon as they arrive in the recipient's inbox.

Important! If DontProcessReceived is set to a non-zero value, this can affect the operation of control actions for incoming emails. First, a control action cannot generate Notify events. Second, if a control action specifies 'Block Quietly', the blocked email arrives and stays in the recipient's inbox until the recipient tries to read the email. At this point, the email is deleted.

Note: A non-zero DontProcessReceived only yields improved performance if Microsoft Outlook is running on the recipient machine at the time when the email arrives.

NoSenderExtendedInfo

Type: REG_DWORD

Data: Specifies that CA DataMinder only extracts basic information for each sender from the Exchange server, including the sender's display name, email address and the address format. Applies to incoming and manually captured emails only.

Default: zero, dlp> extracts basic information plus each sender's 'true' display name and email address aliases.

Important! If NoSenderExtendedInfo is set to a non-zero value, incoming email policy triggers configured to detect a sender's email address will not activate if the targeted address is an alias.

Note: If NoSenderExtendedInfo and DontProcessReceived (see above) are both set to non-zero values, NoSenderExtendedInfo yields improved performance only when incoming emails are read; if DontProcessreceived is zero or does not exist, then a non-zero NoSenderExtendedInfo yields improved performance both when incoming emails arrive in the recipient's inbox and when they are read.

OutlookMonitorIntervalInSeconds

Type: REG_DWORD

Data: Specifies how often CA DataMinder verifies whether the Outlook client agent is disabled in the current session. (A security feature in Outlook can automatically disable certain add-ins). Set this option to 0 to disable monitoring. Specifically, it checks the registry for the wgnemol.dll name and path.

Default: 5 seconds

OutlookRepairDisabledExtension

Type: REG_DWORD

Data: Specifies whether CA DataMinder should re‑enable the Outlook client agent if it is found to be disabled. If this registry value is set to a non-zero value and the Outlook client agent is found to be disabled, CA DataMinder re-enables the client agent and writes a Windows application log entry to that effect.

Default: 0 (do not re-enable)

The transform creates the DWORD registry values in the following registry key on the machine hosting the Outlook client agent:

HKEY_LOCAL_MACHINE\Software\ComputerAssociates\CA DataMinder\CurrentVersion\EMail

Or for 32-bit Outlook client running on a 64-bit OS:

HKEY_LOCAL_MACHINE\Software\WOW6432Node\ComputerAssociates\CA DataMinder\CurrentVersion\EMail