IBM Support

PM90802: EmailRelay fails to parse PostOfficeMode payload if email address contains ampersand '?' character

Fixes are available

Subscribe

You can track all active APARs for this component.

 

APAR status

  • Closed as program error.

Error description

  • IBM Rational ClearQuest (CQ) EmailRelay PostOffice mode e-mail
    payloads will fail to be parsed if the payload contains an email
    address with an apresand '?' character.
    
    Example:
    CQ admin account e-mail address is:
    Administrators?SystemAdmins@company.com
    
    Result:
    No e-mail sent.
    
    SystemOut.log shows:
    [6/10/13 10:05:17:505 CDT] 0000004e EmailRelayCon I   Parameters
    for EmailRelay [server] property: mail.debug=true
    [6/10/13 10:05:17:505 CDT] 0000004e EmailRelaySer I
    startEmailPostOfficeRelayMode ... polling for new email
    [6/10/13 10:05:17:520 CDT] 0000004e EmailRelayPos I
    EmailRelayPostOfficeController ... initializing and starting
    [6/10/13 10:05:17:520 CDT] 0000004e EmailRelayPos I   Processing
    'enabled' CQ repository: 8.0.0_SAMPL
    [6/10/13 10:05:17:661 CDT] 0000004e OslcDbReader  I   URI passed
    to CQ Web:
    http://cq.mycompany.com/cqweb/oslc/repo/8.0.0/db/SAMPL
    [6/10/13 10:05:18:708 CDT] 00000044 CMLogger      I
    com.ibm.rational.stp.server.cq.CqSessionManager createSession
    CRVSV0901I ClearQuest login of user: admin -- 8.0.0/SAMPL on
    server 'ClearQuest - 0.7640'
    [6/10/13 10:05:18:724 CDT] 0000004e OslcDbReader  I   URI passed
    to CQ Web:
    http://cq.mycompany.com/cqweb/oslc/repo/8.0.0/db/SAMPL/simpleQue
    ry/16780612?oslc.select=*?oslc.paging=true?oslc.pageSize=250
    [6/10/13 10:05:18:880 CDT] 0000004e OslcDbReader  E   An
    exception occurred while creating the emails_.
    [6/10/13 10:05:18:895 CDT] 0000004e OslcDbReader  E   The
    reference to entity 'SystemAdmins' must end with the ';'
    delimiter.
                                     org.xml.sax.SAXParseException:
    The reference to entity 'SystemAdmins' must end with the ';'
    delimiter.
     at org.apache.xerces.parsers.DOMParser.parse(Unknown Source)
     at org.apache.xerces.jaxp.DocumentBuilderImpl.parse(Unknown
    Source)
     at
    com.ibm.rational.clearquest.emailrelay.common.XMLUtils.getXMLDoc
    FromString(XMLUtils.java:95)
     at
    com.ibm.rational.clearquest.emailrelay.common.EmailPayloadData.?
    init?(EmailPayloadData.java:247)
     at
    com.ibm.rational.clearquest.emailrelay.common.OslcDbReader.getEm
    ailPayloadData(OslcDbReader.java:307)
     at
    com.ibm.rational.clearquest.emailrelay.common.OslcDbReader.doWor
    k(OslcDbReader.java:110)
     at
    com.ibm.rational.clearquest.emailrelay.servlet.EmailRelayPostOff
    iceController.init(EmailRelayPostOfficeController.java:64)
     at
    com.ibm.rational.clearquest.emailrelay.servlet.EmailRelayServlet
    .startEmailPostOfficeRelayMode(EmailRelayServlet.java:179)
     at
    com.ibm.rational.clearquest.emailrelay.servlet.EmailRelayServlet
    .startEmailRelay(EmailRelayServlet.java:137)
     at
    com.ibm.rational.clearquest.emailrelay.servlet.EmailRelayServlet
    $1.run(EmailRelayServlet.java:88)
     at java.lang.Thread.run(Thread.java:736)
    
    [6/10/13 10:05:18:895 CDT] 0000004e OslcDbReader  I   Attempting
    to send: 0 emails.
    [6/10/13 10:05:18:895 CDT] 0000004e OslcDbReader  I   URI passed
    to CQ Web: http://cq.mycompany.com/cqweb/oslc/session
    

Local fix

Problem summary

  • ****************************************************************
    * USERS AFFECTED:                                              *
    ****************************************************************
    * PROBLEM DESCRIPTION:                                         *
    ****************************************************************
    * RECOMMENDATION:                                              *
    ****************************************************************
    The ClearQuest EmailPlus 2.1 package is not properly
    encoding XML characters in the email field of TO, CC, or BCC
    email addresses.  As a result, any email generated using
    EmailPlus with CQ EmailRelay that has a reserved XML
    character (such as "?") in the email address cannot be sent
    to the intended recipient.
    

Problem conclusion

  • A fix is available in ClearQuest 8.0.0.9 and 8.0.1.2.
    
    The ClearQuest EmailPlus 2.2 package now correctly encodes
    XML characters in the email address field of TO, CC and BCC.
     Emails with reserved XML characters are now sent and
    received correctly using CQ EmailRelay.
    

Temporary fix

Comments

APAR Information

  • APAR number

    PM90802

  • Reported component name

    CLEARQUEST WIN

  • Reported component ID

    5724G3600

  • Reported release

    710

  • Status

    CLOSED PER

  • PE

    NoPE

  • HIPER

    NoHIPER

  • Special Attention

    NoSpecatt

  • Submitted date

    2013-06-10

  • Closed date

    2013-12-13

  • Last modified date

    2013-12-13

  • APAR is sysrouted FROM one or more of the following:

  • APAR is sysrouted TO one or more of the following:

Fix information

  • Fixed component name

    CLEARQUEST WIN

  • Fixed component ID

    5724G3600

Applicable component levels

  • R710 PSN

       UP

[{"Business Unit":{"code":"BU053","label":"Cloud & Data Platform"},"Product":{"code":"SSSH5A","label":"Rational ClearQuest"},"Component":"","ARM Category":[],"Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"7.1","Edition":"","Line of Business":{"code":"LOB36","label":"IBM Automation"}}]

Document Information

Modified date:
13 December 2013