PM71138: BFGIO0178E: A QUEUE WRITE FAILED DUE TO A WMQAPIEXCEPTION WITH MESSAGE TEXT CC=2 RC=2142 MQRC_HEADER_ERROR

WebSphere MQ V7.5 Fix Pack 7.5.0.1
WebSphere MQ File Transfer Edition V7.0 Fix Pack 7.0.4.3

APAR status

• Closed as program error.

Error description

• The following message is observed when making binary mode
  transfers to or from an agent which uses a WebSphere MQ v6
  z/OS queue manager as its agent queue manager:
  
  BFGIO0178E: A QUEUE WRITE FAILED DUE TO A WMQAPIEXCEPTION WITH
  MESSAGE TEXT CC=2 RC=2142 MQRC_HEADER_ERROR
  

Local fix

Problem summary

• ****************************************************************
  USERS AFFECTED:
  All users of WebSphere MQ File Transfer Edition Version 7.0.4
  using agents which communicate with WebSphere MQ v6 z/OS queue
  managers.
  
  
  Platforms affected:
  MultiPlatform
  
  ****************************************************************
  PROBLEM SUMMARY:
  In binary mode transfers, messages places onto the WMQ queues of
  the agent queue manager which represent the bytes of the files
  being transferred incorrectly specified a CCSID of
  MQCCSI_UNDEFINED within the RFH2.
  
  WMQ documentation indicates that MQCCSI_UNDEFINED is not a valid
  value for the CCSID of an RFH2. The z/OS v6 queue manager checks
  this field to ensure it contains a valid value. Because
  MQCCSI_UNDEFINED is not valid MQRC_HEADER_ERROR is returned when
  the agent attempts to perform an MQPUT. This prevents the
  transfer from proceeding and the WMQFTE reason BFGIO0178E is
  given.
  

Problem conclusion

• The code has been altered to use a value of MQCCSI_INHERIT for
  the CCSID within the RFH2 of the messages used for binary mode
  transfers. MQCCSI_INHERIT is a valid value, so it accepted by
  the queue manager and the transfer can complete normally.
  
  ---------------------------------------------------------------
  The fix is targeted for delivery in the following PTFs:
  
  Platform           v7.0
  --------           --------------------
  Multiplatforms     7.0.4.3
  
  Platform           v7.5
  --------           --------------------
  Multiplatforms     7.5.0.1
  
  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