IBM Support

IV43155: AMQ8149 MQ OBJECT DAMAGED ERRORS RECEIVED FOR MULTI-INSTANCE QUEUE MANAGERS USING NFS

Subscribe

You can track all active APARs for this component.

 

APAR status

  • Closed as program error.

Error description

  • MQ objects may be reported as damaged in multi instance queue
    manager environments while using NFS file systems when the
    intr (interrupt) mount option is used. This common mount option
    allows an NFS request to be interrupted if the server is
    unavailable. MQ will report a damaged object with an AMQ8149 as
    well as AMQ9509.
    

Local fix

Problem summary

  • ****************************************************************
    USERS AFFECTED:
    You may encounter this problem if your queue files are accessed
    over NFS. It is likely that the intr (interrupt) mount option
    would need to be in effect for this NFS mount for the problem
    to occur.
    
    Platforms affected:
    All Unix
    
    ****************************************************************
    PROBLEM SUMMARY:
    The queue reading logic assumes that a file read request will
    be satisfied in its entirety, or at least up to end-of-file.
    This has been proven to be the situation in practice at least
    for directly accessed disk systems. However, access via NFS has
    now likely introduced the capability for the low-level file
    read routine to prematurely return having only satisfied part
    of the request (this is known as a "short read"). The
    requirement on the caller is then to re-issue the read with
    the remainder.
    

Problem conclusion

  • Implemented the logic to wrap a read request in a loop to issue
    reads until the full required amount of data has been read, or
    until an error occurs or end-of-file is encountered.
    
    ---------------------------------------------------------------
    The fix is targeted for delivery in the following:
    
                       v7.0
    Platform           Fix Pack 7.0.1.11
    --------           --------------------
    AIX                7.0.1.11
    HP-UX (PA-RISC)    7.0.1.11
    HP-UX (Itanium)    7.0.1.11
    Solaris (SPARC)    7.0.1.11
    Solaris (x86-64)   7.0.1.11
    Linux (x86)        7.0.1.11
    Linux (x86-64)     7.0.1.11
    Linux (zSeries)    7.0.1.11
    Linux (Power)      7.0.1.11
    
                       v7.1
    Platform           Fix Pack 7.1.0.4
    --------           --------------------
    AIX                7.1.0.4
    HP-UX (Itanium)    7.1.0.4
    Solaris (SPARC)    7.1.0.4
    Solaris (x86-64)   7.1.0.4
    Linux (x86)        7.1.0.4
    Linux (x86-64)     7.1.0.4
    Linux (zSeries)    7.1.0.4
    Linux (Power)      7.1.0.4
    
    Version            v7.5
    --------           --------------------
    Fix available in:  7.5.0.3
    
    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

    IV43155

  • Reported component name

    WMQ AIX V7

  • Reported component ID

    5724H7221

  • Reported release

    701

  • Status

    CLOSED PER

  • PE

    NoPE

  • HIPER

    NoHIPER

  • Special Attention

    NoSpecatt

  • Submitted date

    2013-05-24

  • Closed date

    2013-06-14

  • Last modified date

    2013-06-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 AIX V7

  • Fixed component ID

    5724H7221

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 June 2013