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

WebSphere MQ File Transfer Edition V7.0 Fix Pack 7.0.4.4

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 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