IC68793: CLIENTRECONNECTOPTIONS FOR CONNECTION FACTORIES ONLY ACCEPTS 'ANY' AND 'QMGR'. ASYNCEXCEPTION VALUE NAMES NOT DISPLAYED

WebSphere MQ V7.0 Fix Pack 7.0.1.4
WebSphere MQ V7.0.1 for i5/OS Fix Pack 7.0.1.4

APAR status

• Closed as program error.

Error description

• WebSphere MQ 7.0.1 introduces the function of automated
  client reconnection.
  The Information Center describes 4 options for the new
  parameter CLIENTRECONNECTOPTIONS under the section:
  
  http://publib.boulder.ibm.com/infocenter/wmqv7/v7r0/index.jsp?
  topic=/com.ibm.mq.csqzaw.doc/jm10910_.htm
  MQ V7 Information Center
  Properties of WebSphere MQ classes for JMS objects
  
  Column 3 in Table 1 for this new parameter shows 4
  options, but none of them are valid when using JMSAdmin.
  
  The MQ Explorer shows these 4 options in the properties page
  reconnection field for a Connection Factory.
  The Explorer is used 4 times to iterate each of the options
  and then using the JMSAdmin utility to show the values
  for the CLIENTRECONNECTOPTIONS. Only on 2 of these options
  there is a value shown in the attribute:
  
  MQ Explorer: Reconnect to same queue manager
  JMSAdmin:    CLIENTRECONNECTOPTIONS(QMGR)
  
  MQ Explorer: Reconnect
  JMSAdmin:    CLIENTRECONNECTOPTIONS(ANY)
  
  The other 2 options are not shown:
  
  MQ Explorer: Default
  JMSAdmin:    It is not displayed
  
  MQ Explorer: Do not reconnect
  JMSAdmin:    It is not displayed
  
  The expectation is that this attribute should be shown at
  all times in the output of JMSAdmin, including the last 2
  options above. Consequently, it should be possible to
  use JMSAdmin to specify the last 2 options.
  
  The ASYNCEXCEPTION option displays 1 or -1 instead of 'ALL' or
  'CONNECTIONBROKEN'.
  

Local fix

• Use the MQ Explorer to set the 4 options for this attribute.
  

Problem summary

• ****************************************************************
  USERS AFFECTED:
  This issue affects users of the WebSphere MQ v7 classes for Java
  Message Service (JMS) who alter the CLIENTRECONNECTOPTIONS or
  ASYNCEXCEPTION properties on a connection factory using the
  JMSAdmin command line tool.
  
  Platforms affected:
  All Distributed (iSeries, all Unix and Windows) +Java
  ****************************************************************
  PROBLEM SUMMARY:
  The Info Center contained the wrong valid values for the
  ASYNCEXCEPTION and CLIENTRECONNECTOPTIONS properties.
  
  The JMSAdmin tool had not been updated to contain all 4 valid
  values for the CLIENTRECONNECTOPTIONS property.
  
  The JMSAdmin tool was missing the textual representation of the
  valid values for the ASYNCEXCEPTION property.
  

Problem conclusion

• JMSAdmin now accepts all valid values.
  CLIENTRECONNECTOPTIONS:
  ASDEF (default)
  DISABLED
  QMGR
  ANY
  
  ASYNCEXCEPTIONS:
  ALL (default)
  CONNECTIONBROKEN
  
  The "Valid values in administration tool" in the Info Center
  will be updated as follows:
  WMQ_CLIENT_RECONNECT_AS_DEF change to ASDEF
  WMQ_CLIENT_RECONNECT_Q_MGR change to QMGR
  WMQ_CLIENT_RECONNECT change to RECONNECT
  WMQ_CLIENT_RECONNECT_DISABLED change to DISABLED
  
  ---------------------------------------------------------------
  The fix is targeted for delivery in the following PTFs:
  
                     v7.0
  Platform           Fix Pack 7.0.1.4
  --------           --------------------
  Windows            U200323
  AIX                U835793
  HP-UX (PA-RISC)    U836458
  HP-UX (Itanium)    U836463
  Solaris (SPARC)    U836459
  Solaris (x86-64)   U836465
  iSeries            tbc_p700_0_1_4
  Linux (x86)        U836460
  Linux (x86-64)     U836464
  Linux (zSeries)    U836461
  Linux (Power)      U836462
  
  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

• R701 PSY

     UP