control_panel

Sets the e-mail parameters for Rational® ClearQuest® Shipping Server e-mail notification on Windows

Applicability

Product Command type
MultiSite multiutil subcommand
Platform
Windows

Synopsis


control_panel –admin admin-email –smu_p smu_p-server-host
[ –enable_shipping_server_email_notification ]

Description

Use this command to enable e-mail notification when you use the Rational® ClearQuest® Shipping Server with Rational® ClearQuest® MultiSite on the Windows platform.

If you use Rational® ClearQuest® but not DevOps Code ClearCase® MultiSite, use this command to specify the e-mail address and server to use to receive e-mail notification about Rational® ClearQuest® Shipping Server operations.

If you use Rational® ClearQuest® MultiSite and DevOps Code ClearCase® MultiSite, both products use the same e-mail address for notification e-mail.

To use the same e-mail address for Rational® ClearQuest® Shipping Server operations for Rational® ClearQuest® MultiSite and DevOps Code ClearCase® MultiSite, do not use this command. Configure e-mail notification with the MultiSite Control Panel options, using the instructions in this guidethe ClearQuest MultiSite Administrator's Guide.

To use a different e-mail address for Rational® ClearQuest® Shipping Server operations originating from Rational® ClearQuest® MultiSite, use this command to indicate the e-mail address you want to use.

Restrictions

None.

Options and arguments

–admin admin-email
The e-mail address to use for receiving and sending e-mail notification for errors and information sent from the Rational® ClearQuest® Shipping Server. Specify the e-mail address in the following format, where tld is a top level domain:


username@domain.tld

–smu_psmu_p-server-host
The name of the SMTP host that is used with the e-mail address you specified with –admin. If you are using DevOps Code ClearCase® MultiSite and specify a different e-mail address for use with Rational® ClearQuest® MultiSite, you must use the same SMTP server that is used for DevOps Code ClearCase® notification.
–enable_shipping_server_email_notification
Use this argument to enable e-mail notification for Rational® ClearQuest® MultiSite operations that use the Rational® ClearQuest® Shipping Server.

Default: If this option is not used, Rational® ClearQuest® MultiSite uses the e-mail settings for DevOps Code ClearCase® MultiSite. If DevOps Code ClearCase® MultiSite is not installed, you must use this option to enable e-mail notification for the Rational® ClearQuest® Shipping Server.

Examples

In these examples, the lines are broken for readability. You must enter each command on a single physical line.

  • Enables e-mail notification for the Rational® ClearQuest® Shipping Server for Rational® ClearQuest® MultiSite (DevOps Code ClearCase® MultiSite is not installed):



    multiutil control_panel -admin susan@purpledoc.com -smu_p
    mailsrv0.purpledoc.com -enable_shipping_server_email_notification

  • Sets up a separate e-mail address to use for Rational® ClearQuest® MultiSite when DevOps Code ClearCase® MultiSite is also being used:



    multiutil control_panel -admin susan@purpledoc.com -smu_p
    mailsrv0.purpledoc.com