IBM Support

Using Rational ClearQuest SMTP Relay mode in EmailPlus package with EmailRelay results in the SMTP Reply to Address in the EmailPlusSiteConfig being ignored

Technote (troubleshooting)


Problem(Abstract)

If you configure IBM Rational ClearQuest EmailPlus package with EmailRelay, and in EmailPlus "Site Configuration" if you use a different value email value for "SMTP Reply to Address" than "SMTP From Address", users receiving emails generated from ClearQuest EmailPlus package will not be able to reply to the intendant recipient set in "SMTP Reply to Address".

Symptom

Steps to reproduce:

  1. Configure IBM Rational ClearQuest EmailPlus package with EmailRelay
  2. Set a different email address for "SMTP Reply to Address" than for "SMTP From Address"
  3. Use ClearQuest to generate an email
  4. From your email client, attempt to reply-to the email sent from ClearQuest.

Result: The replied-to email will be sent to the address in "SMTP From Address" instead of "SMTP Reply to Address".

Cause

This has been identified as a defect in IBM Rational ClearQuest EmailPlus package.


Resolving the problem

Attention: Test the fix outlined below in a test environment first. Back up your production databases before applying the fix.


Procedure:

  1. Use the packageutil command to enable package editing in your schema repository:

    Usage:
    packageutil enablepackageediting
    [-help] [-dbset dbset_name]
    clearquest_login
    clearquest_password
    [-enable | -disable] user


    Where:
    • dbset_name is the schema repository where the ClearQuest EmailPlus package is applied
    • clearquest_login is the login name for an administrator account
    • clearquest_password is the password for the administrator account
    • -enable enables package editing
    • user is the user who is granted the ability to edit the package

      Command example:

      packageutil enablepackageediting -dbset 8.0.0 admin "" -enable admin


  2. Check out the schema using IBM Rational ClearQuest designer.

  3. In the Perl function EMP_XMLEncode of the global scripts code EMP_Templates, locate the line:


        if(scalar(@{$headers_ref}) > 0)
        {
            foreach my $header (@{$headers_ref})
            {
                # Split the header into its name and value components
                if ($header ne "")
                {
                    my @hdrParts = split/::/ , $header; # <-- this line



    And change it to the following:


                    my @hdrParts = split/:/ , $header; # <-- this line


    Note: The extra ":" was removed

  4. Save the changes and test that emails is being replied to the correct recipient.

  5. Check in the schema and upgrade the database.

  6. Disable package editing:

    Command example:

    packageutil enablepackageediting -dbset 8.0.0 admin "" -disable admin

Document information

More support for: Rational ClearQuest
E-Mail

Software version: 8.0, 8.0.0.1, 8.0.0.2, 8.0.0.3, 8.0.0.4, 8.0.0.5, 8.0.0.6, 8.0.0.7, 8.0.0.8, 8.0.0.9, 8.0.0.10, 8.0.1, 8.0.1.1, 8.0.1.2, 8.0.1.3

Operating system(s): AIX, Linux, Solaris, Windows

Reference #: 1673388

Modified date: 20 May 2014