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.

Configuring the site email options for a single Rational ClearQuest Server 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.

Configuring the site email options for a multiple Rational ClearQuest Server deployment

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.