IBM Support

IT25269: Improve user action description for JMS authentication error messages JMSWMQ2013 and JMSWMQ2021

Subscribe to this APAR

By subscribing, you receive periodic emails alerting you to the status of the APAR, along with a link to the fix after it becomes available. You can track this item individually or track all items by product.

Notify me when this APAR changes.

Notify me when an APAR for this component changes.

 

APAR status

  • Closed as program error.

Error description

  • The user action associated with the MQ classes for JMS error
    message with identifier JMSWMQ2013 could be more detailed.
    Currently, the error message and user action is as follows:
    
    JMSWMQ2013: The security authentication was not valid that was
    supplied for QueueManager 'MY_QMGR' with connection mode
    'CLIENT' and host name 'localhost.
    
    Useraction: Please check if the supplied username and password
    are correct on the QueueManager you are connecting to.
    

Local fix

Problem summary

  • ****************************************************************
    USERS AFFECTED:
    This issue affects users of the IBM MQ classes for JMS that are
    operating using normal mode or normal mode with restrictions.
    
    
    Platforms affected:
    MultiPlatform
    
    ****************************************************************
    PROBLEM DESCRIPTION:
    The IBM MQ classes for JMS error message JMSWMQ2013 is thrown
    when there is an authentication error connecting to the queue
    manager and the IBM MQ reason code MQRC_NOT_AUTHORIZED is
    returned.  Error message JMSWMQ2021 is thrown instead of
    JMSWMQ2013 if the application uses a client channel definition
    table to obtain connection details.
    
    The user action associated with the IBM MQ classes for JMS error
    messages JMSWMQ2013 and JMSWMQ2021 should have included more
    information on how to determine the cause of the authentication
    error.
    

Problem conclusion

  • The user action associated with the IBM MQ classes for JMS error
    messages JMSWMQ2013 and JMSWMQ2021 have been updated to
    reference the 'Securing IBM MQ' section in IBM Knowledge Center
    and suggests reviewing the queue manager error logs for further
    information into why the MQRC_NOT_AUTHORIZED reason code was
    returned.  The user action now reads:
    
    "Please check if the supplied username and password are correct
    on the queue manager to which you are connecting.  For further
    information, review the queue manager error logs and the
    'Securing IBM MQ' topic within IBM Knowledge Center."
    
    ---------------------------------------------------------------
    The fix is targeted for delivery in the following PTFs:
    
    Version    Maintenance Level
    v9.0 LTS   9.0.0.5
    v9.1 CD    9.1.1
    v9.1 LTS   9.1.0.1
    
    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

    IT25269

  • Reported component name

    IBM MQ BASE M/P

  • Reported component ID

    5724H7261

  • Reported release

    900

  • Status

    CLOSED PER

  • PE

    NoPE

  • HIPER

    NoHIPER

  • Special Attention

    NoSpecatt / Xsystem

  • Submitted date

    2018-06-05

  • Closed date

    2018-06-08

  • Last modified date

    2018-07-23

  • 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 M/P

  • Fixed component ID

    5724H7261

Applicable component levels

[{"Business Unit":{"code":"BU053","label":"Cloud & Data Platform"},"Product":{"code":"SSYHRD","label":"IBM MQ"},"Component":"","ARM Category":[],"Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"9.0","Edition":"","Line of Business":{"code":"LOB36","label":"IBM Automation"}}]

Document Information

Modified date:
23 July 2018