IBM Support

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

Subscribe

You can track all active APARs for this component.

 

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 number

    PM71138

  • 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

    2012-08-17

  • Closed date

    2012-09-28

  • Last modified date

    2012-09-28

  • 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:
28 September 2012