Configuring site email options for MAPI

Your Rational® ClearQuest® user account must have the Super User privilege to configure site email options.

When you use MAPI, all email notification messages that Rational® ClearQuest® Web sends have the From and Reply To addresses of the domain-user email account that is configured for Rational® ClearQuest® Web. The email address UserCQWeb@MyExchangeServer is used in the next examples.

The procedure to configure email options for MAPI varies depending on whether your deployment includes a single Rational® ClearQuest® Server or multiple Rational® ClearQuest® Servers. Use one of the next procedures as appropriate for your deployment.

To configure site e-mail options for one Rational® ClearQuest® server computer:

1. Log in to Rational® ClearQuest®.
2. Complete the required information on the E-Mail Options page of the Site Configuration window:
   1. In the Sending E-mail Status list, select Active or Inactive, as appropriate.
   2. In the Mail Transport Type list, select MAPI.
   3. In the MAPI Mail Server field, enter the name of your Microsoft™ Exchange Server. In this example, the MAPI mail server is MyExchangeServer.
   4. In the MAPI Mailbox Alias field, enter the domain-user email account that Rational® ClearQuest® Web uses to send email notification. In this example, the mail account is UserCQWebAlias.

To configure site e-mail options for a multiple Rational® ClearQuest® Server deployment:

Perform these steps identically on each Rational® ClearQuest® Server in your deployment. Do not use the E-mail Options page of the Site Configuration window.

1. Log in by using the domain user name that Rational® ClearQuest® Web uses to send email notification, in this example MyDomain\UserCQWeb.
2. Edit your Windows™ Registry settings by using regedt32. To configure the same settings on each Rational® ClearQuest® Server, create a .reg file and then import it into the regedt32 editor.
   1. Create this key:

      HKEY_CURRENT_USER\Software\Rational Software\Email\SendMail

   2. Create these values under the SendMail key:
      • For SendActive, type one of these DWORD values: 1 for active, 0 for inactive.
      • For MailTransport, type MAPI.
      • For MAPIServer, type the string value for the Microsoft™ Exchange Server, in this example MyExchangeServer.
      • For MAPIProfileAlias, type the string value of the domain-user email account that Rational® ClearQuest® Web uses to send email notification, in this example UserCQWebAlias.

If you change any of these values on one Rational® ClearQuest® Server host in your deployment, you must make the corresponding change on the other hosts.