IBM Support

IC59659: MQGET using a .NET client fails with RC 2499 MQRC_MSG_HANDLE_IN_USE.

Subscribe

You can track all active APARs for this component.

 

APAR status

  • Closed as program error.

Error description

  • An unmanaged .NET client application using multiplexed
    connections failed during the following sequence of calls:
    MQCONN
    MQOPEN
    MQGET
    MQCOMMIT
    MQCLOSE
    MQOPEN
    MQGET
    
    The second of these MQGET operations failed with error
    MQRC_MSG_HANDLE_IN_USE despite it not actually using message
    handles.
    

Local fix

  • test fix supplied to customer
    

Problem summary

  • ****************************************************************
    USERS AFFECTED:
    Users of WebSphere MQ .NET clients using issuing MQGET requests
    with a GMO version less than MQGMO_VERSION_4.
    
    Platforms affected:
    Windows
    
    ****************************************************************
    PROBLEM SUMMARY:
    The issue was caused by the .NET client failing to check the
    version of the GMO in use when determining if the .NET
    application was interested in message properties and wanted to
    use message handles. As a result, the .NET client was checking
    the value of MsgHandle in the GMO even in GMO versions less
    than MQGMO_VERSION_4, contrary to the documented behaviour. If
    the memory pertaining to this field in the client application
    happened to be not NULL, then the MQ client would think that
    the application wished to use message handles. This in turn
    would lead to incorrect message handle processing on the server.
    

Problem conclusion

  • The .NET unmanaged client was modified to ensure that the
    client does not register interest in message properties with
    the server for applications using older GMO versions (pre
    version 4). As such, no message property logic will take place
    on the server.
    
    ---------------------------------------------------------------
    The fix is targeted for delivery in the following PTFs:
    
                       v7.0
    Platform           Fix Pack 7.0.0.2
    --------           --------------------
    Windows            U200302
    
    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

    IC59659

  • 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

    2009-01-26

  • Closed date

    2009-02-11

  • Last modified date

    2009-02-11

  • 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