Fixes are available
Rational ClearQuest Fix Pack 9 (8.0.0.9) for 8.0
Rational ClearQuest Fix Pack 2 (8.0.1.2) for 8.0.1
Rational ClearQuest Fix Pack 11 (8.0.0.11) for 8.0
Rational ClearQuest Fix Pack 4 (8.0.1.4) for 8.0.1
Rational ClearQuest Fix Pack 5 (8.0.1.5) for 8.0.1
Rational ClearQuest Fix Pack 12 (8.0.0.12) for 8.0
Rational ClearQuest Fix Pack 6 (8.0.1.6) for 8.0.1
Rational ClearQuest Fix Pack 13 (8.0.0.13) for 8.0
Rational ClearQuest Fix Pack 14 (8.0.0.14) for 8.0
Rational ClearQuest Fix Pack 7 (8.0.1.7) for 8.0.1
Rational ClearQuest Fix Pack 15 (8.0.0.15) for 8.0
Rational ClearQuest Fix Pack 8 (8.0.1.8) for 8.0.1
Rational ClearQuest Fix Pack 16 (8.0.0.16) for 8.0
Rational ClearQuest Fix Pack 9 (8.0.1.9) for 8.0.1
Rational ClearQuest Fix Pack 17 (8.0.0.17) for 8.0
Rational ClearQuest Fix Pack 10 (8.0.1.10) for 8.0.1
Rational ClearQuest Fix Pack 18 (8.0.0.18) for 8.0
Rational ClearQuest Fix Pack 11 (8.0.1.11) for 8.0.1
Rational ClearQuest Fix Pack 19 (8.0.0.19) for 8.0
Rational ClearQuest Fix Pack 12 (8.0.1.12) for 8.0.1
Rational ClearQuest Fix Pack 20 (8.0.0.20) for 8.0
Rational ClearQuest Fix Pack 13 (8.0.1.13) for 8.0.1
Rational ClearQuest Fix Pack 21 (8.0.0.21) for 8.0
Rational ClearQuest Fix Pack 14 (8.0.1.14) for 8.0.1
Rational ClearQuest Fix Pack 15 (8.0.1.15) for 8.0.1
Rational ClearQuest Fix Pack 16 (8.0.1.16) for 8.0.1
Rational ClearQuest Fix Pack 17 (8.0.1.17) for 8.0.1
Rational ClearQuest Fix Pack 18 (8.0.1.18) for 8.0.1
Rational ClearQuest Fix Pack 19 (8.0.1.19) for 8.0.1
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
Document Information
Modified date:
13 December 2013