GetMailNotificationSettings

Returns the mail notification settings of the mail message.

Description

The configuration information is returned as a reference to an array of strings.

Note: This method is for Perl only. It is not available for VBScript. This method became available in version 2003.06.15.

With support for specifying a character set for email notification other than the default UTF-8 setting, the GetMailNotificationSettings method returns an additional element in the array (compared with versions 7.0.1 and earlier) for this language option for the character set. The additional element is either "" (the default) or the character set encoding name that is set for all outgoing email.

For Windows, the mail settings argument to this method can be in one of the following forms:

where 1 indicates that "send active" is True for SMTP and MAPI protocols (not required by POP3).

The string values in the configuration setting string are based on the mail transport type (SMTP, MAPI, POP3).

For the UNIX systems and Linux, the return value of this method can be:

{"SMTP", "", "", "", "1"}

where 1 indicates that "send active" is True for SMTP.

Note: On the UNIX systems and Linux, the Perl CQMailMsg object uses the sendmail program to send the email message. For this to work properly, sendmail must be configured on the UNIX systems and Linux client machines.
Attention: Rational® ClearQuest® Email 1.x and MAPI support have been deprecated. For enhanced email support, use the EmailPlus 2.1 package. For more information, see EmailPlus package.

Syntax

Perl

$MailMsg->GetMailNotificationSettings();
Identifier
Description
MailMsg
A Mail Message object, representing the mail message to be sent.
Return value
A reference to an array of strings containing the configuration settings for the mail message.

Example

Perl

use strict;
use CQPerlExt;

my $cqmail = CQMailMsg::Build();
my $emailsettings = $cqmail->GetMailNotificationSettings();
foreach my $elem (@$emailsettings) {
      printf $elem. "\n";
   }
CQMailMsg::Unbuild($cqmail);

Feedback