IBM Support

IT02283: "GETDOCUMENTINFO" SERVICE THROWS ERROR WHEN CORRELATION CONTAINS "&" CHARACTER

Subscribe to this APAR

By subscribing, you receive periodic emails alerting you to the status of the APAR, along with a link to the fix after it becomes available. You can track this item individually or track all items by product.

Notify me when this APAR changes.

Notify me when an APAR for this component changes.

 

APAR status

  • Closed as program error.

Error description

  • "GetDocumentInfo" Service throws error when correlation
    contains "&" character.
    
    Error in WF log:-
    
    [2014-05-14 15:15:14.093] ERROR 000110010759
    WORKFLOW.WORKFLOW.ERR_WFCUtil_stringToDocument
    WFCUtil.stringToDocument() converting xml string to DOM obj
    caught parsing exception
    [2014-05-14 15:15:14.093] ERROR 000000000000 GLOBAL_SCOPE
    [1400073314093] The entity name must immediately follow the '&'
    in the entity reference.
    [2014-05-14 15:15:14.093] ERRORDTL 000000000000 GLOBAL_SCOPE
    [1400073314093]org.xml.sax.SAXParseException: The entity name
    must immediately follow the '&' in the entity reference.
        at org.apache.xerces.parsers.DOMParser.parse(Unknown Source)
        at
    com.sterlingcommerce.woodstock.workflow.WFCUtil.stringToDocument
    (WFCUtil.java:91)
    

Local fix

  • STRRTC - 424759
    AE / AE
    Circumvention: None
    

Problem summary

  • USERS AFFECTED:
    ALL
    
    PROBLEM DESCRIPTION:
    GetDocumentInfo Service throws an error when a correlation
    contains "&" character.
    
    PLATFORMS AFFECTED:
    ALL
    

Problem conclusion

  • The issue is caused basically because '&' does not escape as
    '&'.
    Even though this is explicitly set in the Business Process
    (BP), when the value is passed from BP to a specific java class
    for further processing, it is again converted back to '&'.
    Through this APAR this erroneous behavior is corrected.
    Also, this issue was observed when the 'VALUE' element in the
    CorrelationService contained '&' character.
    With the current fix, care is taken to escape the '&'
    character when it is present in both 'NAME' and 'VALUE'
    elements.
    
    DELIVERED IN:
    5020500_12
    5105
    5020601_7
    

Temporary fix

Comments

APAR Information

  • APAR number

    IT02283

  • Reported component name

    STR B2B INTEGRA

  • Reported component ID

    5725D0600

  • Reported release

    510

  • Status

    CLOSED PER

  • PE

    NoPE

  • HIPER

    NoHIPER

  • Special Attention

    NoSpecatt / Xsystem

  • Submitted date

    2014-06-05

  • Closed date

    2016-03-30

  • Last modified date

    2017-03-08

  • 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

    STR B2B INTEGRA

  • Fixed component ID

    5725D0600

Applicable component levels

  • R525 PSY

       UP

[{"Business Unit":{"code":"BU059","label":"IBM Software w\/o TPS"},"Product":{"code":"SS3JSW","label":"IBM Sterling B2B Integrator"},"Component":"","ARM Category":[],"Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"5.1","Edition":"","Line of Business":{"code":"LOB59","label":"Sustainability Software"}}]

Document Information

Modified date:
08 March 2017