IBM Support

IV32331: MAP NEW REASON CODES TO 2059 IN MQ 7.1 BASED ON A USER CONFIGURABLE PARAMETER IN MQ CLIENTS

Subscribe

You can track all active APARs for this component.

 

APAR status

  • Closed as program error.

Error description

  • This APAR will add a new feature to enable MQ client to return
    2059 instead of new reason codes introduced in MQ 7.1 based on
    a user configurable parameter.
    

Local fix

Problem summary

  • ****************************************************************
    USERS AFFECTED:
    Users running unmodified MQ client applications developed
    before MQ release MQ V7.1
    
    Platforms affected:
    All Distributed (iSeries, all Unix and Windows)
    ****************************************************************
    PROBLEM SUMMARY:
    In MQ V7.1, new reason codes (2537, 2538, 2539 and 2540) were
    introduced in addition to 2059, when the queue manager is not
    available. Some applications that depend only on 2059 might
    fail if the applications are not modified to process the new
    reason codes.
    

Problem conclusion

  • MQ client has been modified to return 2059 instead of new
    reason codes based on a new user configurable parameter
    "AMQ_RC_COMPAT_2059".
    
    Procedure:
    
    * Set the environment variable
    
    export AMQ_RC_COMPAT_2059=1
    
    * Restart the client applications
    
    The java client changes will be enabled if either the above
    environment variable is set, or if the JVM parameter is set:
    
    -Dcom.ibm.mq.cfg.AMQ_RC_COMPAT_2059=1
    
    *** This feature has been added to provide sufficient migration
    time for customers running applications developed before MQ 7.1
    release. This feature is available only on MQ 7.1 and MQ 7.5
    and will not be available in future releases. ***
    
    ---------------------------------------------------------------
    The fix is targeted for delivery in the following PTFs:
    
                       v7.1
    Platform           Fix Pack 7.1.0.3
    --------           --------------------
    Windows            7.1.0.3
    AIX                7.1.0.3
    HP-UX (Itanium)    7.1.0.3
    Solaris (SPARC)    7.1.0.3
    Solaris (x86-64)   7.1.0.3
    iSeries            7.1.0.3
    Linux (x86)        7.1.0.3
    Linux (x86-64)     7.1.0.3
    Linux (zSeries)    7.1.0.3
    Linux (Power)      7.1.0.3
    
    Platform           v7.5
    --------           --------------------
    Multiplatforms     7.5.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

    IV32331

  • Reported component name

    WMQ AIX V7

  • Reported component ID

    5724H7221

  • Reported release

    710

  • Status

    CLOSED PER

  • PE

    NoPE

  • HIPER

    NoHIPER

  • Special Attention

    NoSpecatt

  • Submitted date

    2012-11-20

  • Closed date

    2012-12-17

  • Last modified date

    2012-12-17

  • 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 AIX V7

  • Fixed component ID

    5724H7221

Applicable component levels

  • R710 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":"710","Edition":"","Line of Business":{"code":"","label":""}}]

Document Information

Modified date:
17 December 2012