IBM Support

IT27757: INCREMENTAL BACKUP DOES NOT SAVE CHANGED FILE(S) AS EXPECTED

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

  • Under heavy load systems incremental backups do not save all the
    changed file(s).
    A subsequent backup (selective or incremental) on the ignored
    file(s) will result in a successful backup of the same
    
    
    Customer/L2 Diagnostics:
    The issue is caused by the Microsoft function FindNextFile(), in
    that, in rare cases or on a heavily loaded system, file
    attribute information on NTFS file systems may not be current at
    the time this function is called.
    
    IBM Spectrum Protect Server version Affected: Tivoli Storage
    Manager client v7.1 and IBM Spectrum Protect client v8.1 on
    Windows platform
    
    Initial Impact: Low
    
    Additional Keywords: TS001067727 incremental backup ignored file
    missed skipped TSM
    

Local fix

  • Add  in the dsm.opt file the following option:
    testflag ENABLEGETFILSIZE
    

Problem summary

  • ****************************************************************
    * USERS AFFECTED:                                              *
    * Backup-archive client versions 7.1 and 8.1 running on all    *
    * Microsoft Windows platforms.                                 *
    ****************************************************************
    * PROBLEM DESCRIPTION:                                         *
    * See ERROR DESCRIPTION                                        *
    ****************************************************************
    * RECOMMENDATION:                                              *
    * This issue is projected to be fixed in the Backup-Archive    *
    * Client version 8.1.8 on all Microsoft Windows platforms      *
    * Note that this is subject to change at the discretion of     *
    * IBM.                                                         *
    ****************************************************************
    

Problem conclusion

  • Sometimes the attributes returned from the Windows API
    FindNextFile() differ from the server data.
    Microsoft states that in rare cases or on a heavily loaded
    system, file attribute information on NTFS file systems
    may not be current at the time this function is called. To be
    assured of getting the current NTFS file system file attributes,
    call the GetFileInformationByHandle function.
    FindNextFile() cannot be replaced with GetFileAttributesEx()
    because of performance degradation. But the API
    GetFileAttributesEx()
    can be called under the existent testflag ENABLEGETFILSIZE
    

Temporary fix

Comments

APAR Information

  • APAR number

    IT27757

  • Reported component name

    TSM CLIENT

  • Reported component ID

    5698ISMCL

  • Reported release

    71W

  • Status

    CLOSED PER

  • PE

    NoPE

  • HIPER

    NoHIPER

  • Special Attention

    NoSpecatt / Xsystem

  • Submitted date

    2019-01-14

  • Closed date

    2019-01-31

  • Last modified date

    2019-01-31

  • 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

    TSM CLIENT

  • Fixed component ID

    5698ISMCL

Applicable component levels



Document information

More support for: Tivoli Storage Manager

Software version: 71W

Reference #: IT27757

Modified date: 31 January 2019