IBM Support

IC79103: WMQ EXPLORER CONNECTION TO QUEUE MANAGER FAILS WHEN THE QUEUE MANAGER DOES NOT SUPPORT OPTIONAL INTERNAL CALLS IN FAP9 SPEC.

Subscribe

You can track all active APARs for this component.

 

APAR status

  • Closed as program error.

Error description

  • Applications using the WebSphere MQ classes for Java or classes
    for JMS receive completion code '2' with reason code 2298
    (MQRC_FUNCTION_NOT_SUPPORTED), when performing an MQPUT or JMS
    send(Message) operation.  The operation is not successful.
    
    The issue is also encountered inside WebSphere MQ Explorer,
    reporting 2298 (MQRC_FUNCTION_NOT_SUPPORTED) when attempting to
    establish an administrative connection to a remote queue
    manager.
    

Local fix

Problem summary

  • ****************************************************************
    USERS AFFECTED:
    This issue affects users of:
    
    - The v7 WebSphere MQ classes for Java
    - The v7 WebSphere MQ classes for JMS
    
    Who are trying to PUT a message to a queue manager that
    supports WebSphere MQ Formats and Protocols (FAP) version 9 or
    higher, but does not support some of the optional internal
    functionality from the specification.
    
    OR
    
    Users of WebSphere MQ Explorer who are attempting to connect to
    a queue manager that supports FAP version 9 or higher but does
    not support some of the optional internal functionality from
    the specification.
    
    The issue is known to affect clients connecting to certain
    levels of WebSphere MQ for z/VSE queue managers.  Connections
    to queue managers on distributed (UNIX and Windows) platforms
    at v7.0, and connections to queue managers on distributed
    platforms and z/OS at v7.1, are unaffected by this issue.
    
    Platforms affected:
    All Distributed (iSeries, all Unix and Windows) +Java +Java zOS
    ****************************************************************
    PROBLEM SUMMARY:
    When connecting to a queue manager, the WebSphere MQ classes
    for Java/JMS check whether the queue manager has support for
    certain WebSphere MQ internal operations.  As part of this,
    the WebSphere MQ Formats and Protocols (FAP) level is
    negotiated between the client and the queue manager.
    
    As part of this negotiation, the client checks if the queue
    manager supports certain optional parts of the FAP
    specification.  The client records the outcome of this check
    in the properties of the connection.
    
    In the failing case, the client incorrectly assumed that all
    queue managers supporting FAP version 9 or higher also support
    some optional parts of the specification.  This resulted in
    requests being made to the queue manager using internal
    communication functionality which the queue manager did not
    support.
    
    In the case of a MQPUT operation, this resulted in a MQRC 2298
    (MQRC_FUNCTION_NOT_SUPPORTED) response being returned from
    the queue manager, indicating that the MQPUT operation had
    failed.
    
    When using the WebSphere MQ Explorer, MQPUT operations are
    made to the queue manager's command queue as part of the
    process of establishing the administrative connection.  This
    issue caused the MQPUT operation to fail, with the result that
    the WebSphere MQ Explorer was not able to successfully connect
    to the queue manager.
    

Problem conclusion

  • The WebSphere MQ classes for Java/JMS have been modified so that
    calls using the optional internal functionality are not made
    during an MQPUT operation, if the queue manager has
    notified the client that this functionality is not available.
    
    
    ---------------------------------------------------------------
    The fix is targeted for delivery in the following PTFs:
    
                       v7.0
    Platform           Fix Pack 7.0.1.8
    --------           --------------------
    Windows            U200335
    AIX                U845856
    HP-UX (PA-RISC)    U847965
    HP-UX (Itanium)    U847970
    Solaris (SPARC)    U847966
    Solaris (x86-64)   U847972
    iSeries            7.0.1.8
    Linux (x86)        U847967
    Linux (x86-64)     U847971
    Linux (zSeries)    U847968
    Linux (Power)      U847969
    zOS                7.0.1.8
    
                       v7.1
    Platform           Fix Pack 7.1.0.2
    --------           --------------------
    Windows            U200351
    AIX                U853019
    HP-UX (Itanium)    U853052
    Solaris (SPARC)    U853048
    Solaris (x86-64)   U853054
    iSeries            7.1.0.2
    Linux (x86)        U853049
    Linux (x86-64)     U853053
    Linux (zSeries)    U853050
    Linux (Power)      U853051
    zOS                7.1.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

    IC79103

  • 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

    2011-10-06

  • Closed date

    2011-11-02

  • Last modified date

    2012-08-07

  • 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:
07 August 2012