IBM Support

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

Subscribe

You can track all active APARs for this component.

 

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 number

    IC68793

  • Reported component name

    WMQ WINDOWS V7

  • Reported component ID

    5724H7220

  • Reported release

    701

  • Status

    CLOSED PER

  • PE

    NoPE

  • HIPER

    NoHIPER

  • Special Attention

    NoSpecatt

  • Submitted date

    2010-05-21

  • Closed date

    2010-06-25

  • Last modified date

    2010-07-14

  • 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

[{"Business Unit":{"code":"BU048","label":"IBM Software"},"Product":{"code":"SSCPQ63","label":"APAR \/ Maintenance"},"Component":"","ARM Category":[],"Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"7.0.1","Edition":"","Line of Business":{"code":"","label":""}}]

Document Information

Modified date:
14 July 2010