Configure email options for MAPI.
Important: Starting in Rational ClearQuest 8.0.0.3,
the ClearQuest E-Mail 1.x package and MAPI support are deprecated.
For enhanced email support, use the ClearQuest EmailPlus 2.1 package.
For more information, see
EmailPlus package.
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:
- Log in to Rational ClearQuest.
- Complete the required information on the E-Mail Options page
of the Site Configuration window:
- In the Sending E-mail Status list, select Active or Inactive,
as appropriate.
- In the Mail Transport Type list, select MAPI.
- In the MAPI Mail Server field, enter the
name of your Microsoft Exchange Server. In this example, the MAPI
mail server is MyExchangeServer.
- 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
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.
To configure
site e-mail options for a multiple Rational ClearQuest Server
deployment:
- Log in by using the domain user name that Rational ClearQuest Web
uses to send email notification, in this example MyDomain\UserCQWeb.
- 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.
- Create this key:
HKEY_CURRENT_USER\Software\Rational
Software\Email\SendMail
- 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.