IT28748: dmpmqcfg fails to connect in client mode when using non-multiplexed connection

APAR status

• Closed as program error.

Error description

• The dmpmqcfg command connects to a queue manager and the error
  reported to stderr is;
  
   AMQ8921E: MQCB call failed with reason code 2298.
  
  Using the mqrc tool, the 2298 return code is defined as
  "Function not supported";
  
   2298  0x000008fa  MQRC_FUNCTION_NOT_SUPPORTED
  
  The dmpmqcfg command also returns a non zero return code (71)
  indicating an unexpected error occurred and the command failed.
  In this type of failure no data is written to stdout, this is
  expected behaviour.
  
  dmpmqcfg should fallback to use MQGET if asynchronous consume is
  not available, for example on a non-multiplexed connection.
  

Local fix

• n/a
  

Problem summary

• ****************************************************************
  USERS AFFECTED:
  Users using dmpmqcfg to connect to a queue manager using a
  client connection (-c) are potentially affected, if the client
  connection does not permit asynchronous consume.
  
  
  Platforms affected:
  MultiPlatform
  
  ****************************************************************
  PROBLEM DESCRIPTION:
  dmpmqcfg uses MQ's asynchronous consume feature to retrieve PCF
  responses from the command server. When dmpmqcfg is connected
  using client bindings however, it may not be possible to use
  asynchronous consume. This is true for example when SHARECNV(0)
  is negotiated.
  

Problem conclusion

• Asynchronous consume will continue to be used when available,
  however dmpmqcfg will fallback to use MQGET if asynchronous
  consume is not available.
  
  ---------------------------------------------------------------
  The fix is targeted for delivery in the following PTFs:
  
  Version    Maintenance Level
  v8.0       8.0.0.13
  v9.0 LTS   9.0.0.8
  v9.1 CD    9.1.3
  v9.1 LTS   9.1.0.4
  
  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

  IBM MQ BASE MP

• Fixed component ID

  5724H7251

Applicable component levels