JR53951: YOU RECEIVE AN ILLEGALDATAEXCEPTION IN IBM BPM BECAUSE INVALID XML CHARACTERS ARE IDENTIFIED DURING XML SERIALIZATION

8.5.0.1-WS-BPM-IFJR53951
8.5.5.0-WS-BPM-IFJR53951
bpm.8560.cf1.delta.repository.2
bpm.8560.cf1.delta.repository.1
8.5.6.0-WS-BPM-IFJR53951
Version 8.5.0 Fix Pack 2 for the IBM Business Process Manager products
Version 8.5 Refresh Pack 7 for the IBM Business Process Manager products

APAR status

• Closed as program error.

Error description

• When you try to convert a string that contains ASCII control
  characters to XML, you receive an IllegalDataException during
  the serialization.
  
  [7/28/15 10:04:11:732] 0000013f wle            X
  com.lombardisoftware.core.ExceptionHandler ensureSerializable
  ensureSerializable(org.jdom.IllegalDataException: The data ...
  ..........  is not legal for a JDOM
  character content: 0x1a is not a legal XML character.)
  
  .-----------------------------------------------
  Caused by: org.jdom.IllegalDataException: The data "Runtime
  error in script" is not legal for a JDOM character content:
  0xd844 is not a legal XML character.
     at org.jdom.Text.setText(Text.java:195)
     at org.jdom.Text.(Text.java:104)
     at org.jdom.Element.setText(Element.java:738)
     at com.lombardisoftware.server.core.ExceptionMapper.
        manualConvertToXml(ExceptionMapper.java:102)
     at com.lombardisoftware.server.core.ExceptionMapper.toXML
        (ExceptionMapper.java:93)
     at
  com.lombardisoftware.server.ejb.workflow.EJBWorkflowManagerBean.
        doResumeWorkflowEngine(EJBWorkflowManagerBean.java:1306)
     at
  com.lombardisoftware.server.ejb.workflow.EJBWorkflowManagerBean.
        resumeTask(EJBWorkflowManagerBean.java:296)
  

Local fix

Problem summary

• The tw.system.serializer.toXml JavaScript API allows a TWObject
  as input that is then parsed and converted into XML. However, if
  the TWObject contains a string that contains invalid XML
  characters, such as control characters 0x01 or 0x02, you receive
  an IllegalDataException.
  

Problem conclusion

• A fix that automatically removes invalid characters in string
  input so that the string is XML compliant
  - will be available for IBM BPM V8.5.5.0
  - will be in an IBM BPM V8.5.6.0 Cumulative Fix
  
  On Fix Central (http://www.ibm.com/support/fixcentral), search
  for JR53951:
  
  1. Select IBM Business Process Manager with your edition from
    the product selector, the installed version to the fix pack
    level, and your platform, and then click Continue.
  
  2. Select APAR or SPR, enter JR53951, and click Continue.
  
  When you download fix packages, ensure that you also download
  the readme file for each fix. Review each readme file for
  additional installation instructions and information about the
  fix.
  
  For the fix to take effect, you must activate it by setting the
  following configuration flag in the 100Custom.xml file and
  restarting the server:
  
      <server>
          <autocorrect-xml>true</autocorrect-xml>
      </server>
  

Temporary fix

• Not applicable
  

Comments

APAR Information

• 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

  BPM STANDARD

• Fixed component ID

  5725C9500

Applicable component levels

• R850 PSY

     UP

• R855 PSY

     UP

• R856 PSY

     UP