IC60386: V7 C++ CLIENT MQGMO_CONVERT RETURNS MQRC_FUNCTION_NOT_SUPPORTED

WebSphere MQ V7.0 Fix Pack 7.0.1.1
WebSphere MQ V7.0 Fix Pack 7.0.1.2

APAR status

• Closed as program error.

Error description

• v7 C++ applications returned the error 2298
  (MQRC_FUNCTION_NOT_SUPPORTED) when all of the following
  conditions are met:
  a) The application issues the Get call with MQGMO_CONVERT
  b) The application uses automatic allocation of memory for the
  message using automaticBuffer()
  c) Either the queue manager is V6 or sharing conversations
  is disabled on a V7 queue manager (SHARECNV on the channel is
  0).
  

Local fix

• None, Install fix. C++ application ran fine at v6.
  The V7 C++ client can return MQRC_FUNCTION_NOT_SUPPORTED. This
  happenswhen sharing conversations is not enabled and a message
  is got with MQGMO_CONVERT using a message buffer that is
  supplied automatically.
  Sharing conversations is not enabled when communicating with a
  pre V7 queue managers or when SHARECNV on the CLNTCONN or
  SVRCONN channel is set to 0.
  

Problem summary

• ****************************************************************
  USERS AFFECTED:
  Users of the v7 C++ client applications when MQGMO_CONVERT and
  automaticBuffer() are used together with sharing of
  conversations disabled.
  
  Platforms affected:
  All Distributed (iSeries, all Unix and Windows)
  ****************************************************************
  PROBLEM SUMMARY:
  The new code introduced for v7 makes an incorrect validation
  check when sharing conversations are disabled and hence
  reported the MQRC_FUNCTION_NOT_SUPPORTED error.
  

Problem conclusion

• The incorrect check during an MQGET call was modified so that
  the error does not occur.
  
  ---------------------------------------------------------------
  The fix is targeted for delivery in the following PTFs:
  
                     v7.0
  Platform           Fix Pack 7.0.1.0
  --------           --------------------
  Windows            U200306
  AIX                U823774
  HP-UX (PA-RISC)    U823665
  HP-UX (Itanium)    U823667
  Solaris (SPARC)    U823772
  Solaris (x86-64)   U824344
  iSeries            tbc_p700_0_1_0
  Linux (x86)        U823664
  Linux (x86-64)     U823773
  Linux (zSeries)    U823668
  Linux (Power)      U823666
  
  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 WINDOWS V7

• Fixed component ID

  5724H7220

Applicable component levels

• R700 PSY

     UP