IBM Support

IV33784: XMS.NET v2.0.0.9 CLIENT FAILS WITH REASON 2190(MQRC_CONVERTED_STRING_TOO_BIG)DURING CONSUMER.RECEIVE

Fixes are available

WebSphere MQ V7.0 Fix Pack 7.0.1.10
WebSphere MQ V7.5 Fix Pack 7.5.0.2
Fix Pack 7.1.0.3 for WebSphere MQ V7.1
WebSphere MQ v7.5.0.2 Hypervisor for RHEL

Subscribe

You can track all active APARs for this component.

 

APAR status

  • Closed as program error.

Error description

  • When application using XMS .NET v2.0.0.9 issues
Consumer.Receive, it fails with reason 2190
MQRC_CONVERTED_STRING_TOO_BIG. This problem will be seen only
for the applications using XMS .NET v2.0.0.9

Following will be series of actions that take place before we
see this error
1) The Client application performs a Consumer.Receive with the
convert option(MQGMO_CONVERT)

2) If the message that resides on the target queue exceeds the
size of the buffer that the client has supplied. The Queue
Manager then reports this via return code 2080:
"rc=MQRC_TRUNCATED_MSG_FAILED" and notifies the client of the
actual size of the unconverted message.

3) The Client performs a new MQGET (second part of a two-stage
get) with convert and supplies the new buffer size correct size.

4) The Queue Manager accepts that the buffer size is sufficient
for the message and then performs the conversion. Incase the
conversion was from a single byte code page (37 EBCDIC) to a
multi byte code page (1208), the message grows in size when it
is converted, such that it exceeds the size of the defined
buffer. The Queue Manager reports this via the warning return
code 2190 "rc=MQRC_CONVERTED_STRING_TOO_BIG" and the Client
receives the unconverted message.

Trace snippet that shows above sequence of errors.
----------------------------------------------------------------
000015B4 11:41:27.215762 ~AMQ10292.0.TRC <-- MQGET (HConn='7',
Hobj='66',P,SyncIfP,ResolvedQ='xx.xx.xx',BufLen=5120), rc=2080
(Truncated message failed.), cc=Warning, tid(1)
000015C6 11:41:27.215856  AMQ10292.0.TRC ------{  cciTcpReceive
000015CD 11:41:27.215893  AMQ10292.0.TRC ---}! MQGET
(rc=MQRC_TRUNCATED_MSG_FAILED)
000015D6 11:41:27.215939  AMQ10292.0.TRC --}! MQGET
(rc=MQRC_TRUNCATED_MSG_FAILED)
...
00001732 11:41:27.243760 ~AMQ10292.0.TRC <-- MQGET (HConn='7',
Hobj='66',P,SyncIfP,ResolvedQ='xx.xx.xx',BufLen=88177), rc=2190
(Converted string too big), cc=Warning, tid(1)
00001743 11:41:27.243831  AMQ10292.0.TRC ---}! MQGET
(rc=MQRC_CONVERTED_STRING_TOO_BIG)
00001748 11:41:27.243866  AMQ10292.0.TRC --}! MQGET
(rc=MQRC_CONVERTED_STRING_TOO_BIG)
----------------------------------------------------------------

Once the above warning is received, XMS .NET Client was raising
it as an exception.

Local fix

  • 



Problem summary


    

  • ****************************************************************
USERS AFFECTED:
All XMS .NET v2.0.0.9 applications that use Synchronous
Consumer.Receive() calls.

Platforms affected:
Windows

****************************************************************
PROBLEM SUMMARY:
When application using XMS .NET v2.0.0.9 issues
Consumer.Receive, it fails with reason 2190
MQRC_CONVERTED_STRING_TOO_BIG. This problem will be seen only
for the applications using XMS .NET v2.0.0.9. In this case, once
XMS .NET client gets unconverted message with a warning on the
MQGET call, it should accept it and try for the client side
conversion.

    



Problem conclusion


    

  • XMS .NET code has been fixed to handle 2190
MQRC_CONVERTED_STRING_TOO_BIG error during an MQGET call with
insufficient buffer.

---------------------------------------------------------------
The fix is targeted for delivery in the following PTFs:

                   v7.1
Platform           Fix Pack 7.1.0.3
--------           --------------------
Windows            7.1.0.3

                   v7.0
Platform           Fix Pack 7.0.1.10
--------           --------------------
Windows            7.0.1.10

Platform           v2.5
--------           --------------------
Multiplatforms     7.5.0.2

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

  • Reported component name
    MSG SRVCS CL .N
    • 

  • Reported component ID
    5724M2100
    • 

  • Reported release
    200
    • 

  • Status
    CLOSED  PER
    • 

  • PE
    NoPE
    • 

  • HIPER
    NoHIPER
    • 

  • Special Attention
    NoSpecatt
    • 

  • Submitted date
    2012-12-20
    • 

  • Closed date
    2013-01-24
    • 

  • Last modified date
    2013-03-05
    • 





    

  • 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
    MSG SRVCS CL .N
    • 

  • Fixed component ID
    5724M2100
    • 



Applicable component levels


    

  • R200  PSY
       UP
    • 








      
              
                            

              

              [{"Business Unit":{"code":"BU048","label":"IBM Software"},"Product":{"code":"SSCRTPP","label":"SupportPac"},"Component":"","ARM Category":[],"Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"2.0","Edition":"","Line of Business":{"code":"","label":""}}]
              

                          

          
 
        

      

    

      

        

          

            
Document Information


            

            


                        

            Modified date:
            

            05 March 2013
            

            
                      

        


        

        


      

    

  



    

  

  
    
            

          
Page Feedback