IBM Support

IC58266: Client application receives a MQRC_CONNECTION_BROKEN (2009) error when issuing an MQOPEN request against an HCONN.

Subscribe

You can track all active APARs for this component.

 

APAR status

  • Closed as program error.

Error description

  • A client application attempted to connect to a queue manager.
    This succeeded but a subsequent MQOPEN call against the
    returned HCONN resulted in MQRC_CONNECTION_BROKEN. The client
    application was using a client channel definition table with
    multiple channel definitions to the queue manager, some of
    which contained security exit definitions. The client was
    iterating through each of the definitions in an attempt to
    connect. One of these connections was forcibly terminated on
    the server-side by a security exit. The following connection
    succeeded, only to fail on a subsequent MQOPEN.
    

Local fix

Problem summary

  • ****************************************************************
    USERS AFFECTED:
    Any users of WebSphere MQ using multiple channel definitions in
    a CCDT.
    
    Platforms affected:
    All Distributed (iSeries, all Unix and Windows)
    ****************************************************************
    PROBLEM SUMMARY:
    The problem was caused by a flag that had been set for a
    previous connection attempt during the client logic to iterate
    through the client channel definition table when connecting to
    the queue manager. As the result of a partial failed attempt
    (the client had established initial communications with the
    remote queue manager but the conversation was abruptly
    terminated by a server-side security exit), the
    CONNECTION_BROKEN flag was set on the conversation handle
    belonging to the HCONN. This then persisted for the subsequent
    connection attempt using the CCDT. Upon successful completion
    of this MQCONN attempt, the client then issued an MQOPEN. As
    part of this API call, MQ performed validation against the
    conversation and found that this conversation was marked as
    broken. As a result, it returned MQRC_CONNECTION_BROKEN.
    

Problem conclusion

  • The connection broken flag was switched off appropriately when
    iterating through channel definitions in the channel definition
    table.
    
    ---------------------------------------------------------------
    The fix is targeted for delivery in the following PTFs:
    
                       v7.0
    Platform           Fix Pack 7.0.0.1
    --------           --------------------
    Windows            U200301
    AIX                U821414
    HP-UX (PA-RISC)    U820765
    HP-UX (Itanium)    U821296
    Solaris (SPARC)    U820766
    Solaris (x86-64)   U820880
    iSeries            tbc_p700_0_0_1
    Linux (x86)        U821407
    Linux (x86-64)     U821295
    Linux (zSeries)    U821294
    Linux (Power)      U820881
    
    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

    IC58266

  • Reported component name

    WMQ WINDOWS V7

  • Reported component ID

    5724H7220

  • Reported release

    700

  • Status

    CLOSED PER

  • PE

    NoPE

  • HIPER

    NoHIPER

  • Special Attention

    NoSpecatt

  • Submitted date

    2008-10-07

  • Closed date

    2008-10-23

  • Last modified date

    2009-03-10

  • 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 WINDOWS V7

  • Fixed component ID

    5724H7220

Applicable component levels

  • R700 PSY

       UP

[{"Business Unit":{"code":"BU059","label":"IBM Software w\/o TPS"},"Product":{"code":"SSDEZSF","label":"IBM WebSphere MQ Managed File Transfer for z\/OS"},"Component":"","ARM Category":[],"Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"7.0","Edition":"","Line of Business":{"code":"LOB45","label":"Automation"}}]

Document Information

Modified date:
31 March 2023