IBM Support

PM88808: WEBSPHERE MQ FTE V7 FAILS WITH BFGIO0060E ERROR ALTHOUGH "TEXTREPLACEMENTCHARACTERSEQUENCE" PROPERTY IS SET.

Subscribe

You can track all active APARs for this component.

 

APAR status

  • Closed as program error.

Error description

  • When WebSphere MQ File Transfer Edition (FTE) version 7.0.4.1
    is trying to transfer a file with
    "textReplacementCharacterSequence" set in the destination agent
    properties file, failure occurs with error BFGIO0060E (Text
    data conversion has failed).
    
    The successful completion of file transfer with the specified
    character inserted for unmappable character is not occurring as
    expected.
    

Local fix

Problem summary

  • ****************************************************************
    USERS AFFECTED:
    This issue affects users of WebSphere MQ File Transfer Edition
    V7.0.4 who are performing text transfers and have configured a
    value for the "textReplacementCharacterSequence " property in
    the agent.properties file of their destination Agent.
    
    
    Platforms affected:
    MultiPlatform
    
    ****************************************************************
    PROBLEM SUMMARY:
    When unmappable characters were encountered during the
    decoding phase of text conversion, the WebSphere MQ File
    Transfer Edition text converter was not replacing these
    characters with the sequence specified by the
    "textReplacementCharacterSequence" property of the destination
    agent. Instead, the transfer was failing with the following
    error code: BFGIO0060E.
    
    This was a consequence of incorrect configuration of the
    WebSphere MQ File Transfer Edition text converter. The
    replacement sequence specified by the
    "textReplacementCharacterSequence" property of the destination
    agent was only being used to replace unmappable characters
    during the encoding phase of the text conversion and not the
    decoding phase.
    

Problem conclusion

  • The WebSphere MQ File Transfer Edition text converter has been
    modified such that the replacement character sequence
    specified by the "textReplacementCharacterSequence" property
    of the agent.properties file of the destination agent is now
    correctly utilised for unmappable characters encountered
    during the decoding phase of text conversion.
    
    ---------------------------------------------------------------
    The fix is targeted for delivery in the following PTFs:
    
    Platform           v7.5
    --------           --------------------
    Multiplatforms     7.5.0.3
    
    Platform           v7.0
    --------           --------------------
    Multiplatforms     7.0.4.4
    
    The latest available maintenance can be obtained from
    'WebSphere MQ Recommended Fixes'
    http://www-1.ibm.com/support/docview.wss?rs=171&uid=swg27006037
    
    If the maintenance level is not yet available information on
    its planned availability can be found in 'WebSphere MQ
    Planned Maintenance Release Dates'
    http://www-1.ibm.com/support/docview.wss?rs=171&uid=swg27006309
    ---------------------------------------------------------------
    

Temporary fix

Comments

APAR Information

  • APAR number

    PM88808

  • Reported component name

    WMQ FTE Z/OS

  • Reported component ID

    5655U8000

  • Reported release

    704

  • Status

    CLOSED PER

  • PE

    NoPE

  • HIPER

    NoHIPER

  • Special Attention

    NoSpecatt

  • Submitted date

    2013-05-10

  • Closed date

    2013-05-28

  • Last modified date

    2014-03-25

  • 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

    WMQ FTE Z/OS

  • Fixed component ID

    5655U8000

Applicable component levels

  • R704 PSY

       UP

[{"Business Unit":{"code":"BU048","label":"IBM Software"},"Product":{"code":"SSCPQ63","label":"APAR \/ Maintenance"},"Component":"","ARM Category":[],"Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"704","Edition":"","Line of Business":{"code":"","label":""}},{"Business Unit":{"code":"BU054","label":"Systems w\/TPS"},"Product":{"code":"SG19M","label":"APARs - z\/OS environment"},"Component":"","ARM Category":[],"Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"704","Edition":"","Line of Business":{"code":"","label":""}}]

Document Information

Modified date:
25 March 2014