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 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