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

Fixes are available

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":"LOB45","label":"Automation"}}]

Document Information

Modified date:
13 December 2013

Tips

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

Fixes are available

Subscribe

APAR status

Closed as program error.

Error description

Local fix

Problem summary

Problem conclusion

Temporary fix

Comments

APAR Information

APAR number

Reported component name

Reported component ID

Reported release

Status

PE

HIPER

Special Attention

Submitted date

Closed date

Last modified date

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

Fixed component ID

Applicable component levels

R710 PSN

Document Information

Share your feedback

Need support?