IBM Support

IT19057: SYSTEMSTATE RESTORE FAILS TO RESTORE SHORTNAMES CORRECTLY

Subscribe

You can track all active APARs for this component.

APAR status

  • Closed as program error.

Error description

  • When using the Tivoli Storage Manager or IBM Spectrum protect
    Backup Archive client to perform a restore of the systemstate, a
     shortname may get restored with an incorrect digit in the 8.3
    naming convention if the backup of the systemstate is enabled
    with the "ENABLE8DOT3NAMESUPPORT YES" option.
    
    Customer/L2 Diagnostics (If Applicable)
    
    APAR IT03300 originally addressed the issue of including the
    shortnames correctly within the systemstate, but a further issue
    was found during the restore if the shortname is a hardlink.
    Messages similar to the following are seen within the clients
    error log :
    
    ANS1796I The short name for '...\ProgramData' could not be set
    to original short name 'PROGRA~3': Windows function
    'SetFileShortName' failed with return code 183...
    
    The above error indicates that the file already exists.  An
    issue was found during the restore, in that the path is created
    by the operating system and assigned a shortname, but due to the
    ENABLE8DOT3NAMESUPPORT option being set, we fail to remove the
    shortname given by the operating system so assign a different
    shortname resulting in a different filename being restored.
    
    An example of this could be as follows :
    
    On a system that has been backed up :
    ...
    26.04.2016  00:26    <DIR>          PROGRA~1     Program Files
    11.08.2016  12:01    <DIR>          PROGRA~2     Program Files
    (x86)
    ...
    
    After restoring the systemstate :
    ...
    11.08.2016  12:58    <DIR>          PROGRA~1     Program Files
    21.07.2016  07:22    <DIR>          PROGRA~3     Program Files
    (x86)
    
    This can affect applications which lookup and use the shortname
    from the registry which is still set to the original name. They
    may fail to start and remain in a "starting" state as the
    shortname within the registry no longer matches the shortname
    that is restored.
    
    | MDVPARTL 7.1.2.0-TIV_5698MCL | (IT03300)
    
    Tivoli Storage Manager Versions Affected:
    Tivoli Storage Manager and IBM Spectrum Protect version 6.3,
    6.4, 7.1 and above on Windows
    
    Initial Impact: Low|Medium|High
    Medium
    
    Additional Keywords:
    TSM, Spectrum Protect,  BMR, bare metal restore, disaster
    recovery
    

Local fix

  • For any application that fails to start, perform a "repair
    install" of the application which corrects the shortname.
    

Problem summary

  • ****************************************************************
    * USERS AFFECTED:                                              *
    * Backup-archive client versions 6.4.3, 7.1.0-7.1.6 and 8.1.0  *
    * running on all Microsoft Windows platforms                   *
    ****************************************************************
    * PROBLEM DESCRIPTION:                                         *
    * See ERROR DESCRIPTION                                        *
    ****************************************************************
    * RECOMMENDATION:                                              *
    * Apply fixing level when available. This problem is currently *
    * projected to be fixed in level 8.1.2. Note that this is      *
    * subject to change at the discretion of IBM.                  *
    ****************************************************************
    

Problem conclusion

  • When using the backup-archive client to perform a restore of the
    systemstate, a shortname may get restored with an incorrect
    name. It is occur because the reparse points were incorrectly
    handled by the backup-archive client. The client set short name
    on target instead of source.
    

Temporary fix

Comments

APAR Information

  • APAR number

    IT19057

  • 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

    2017-02-01

  • Closed date

    2017-03-16

  • Last modified date

    2017-03-16

  • APAR is sysrouted FROM one or more of the following:

  • APAR is sysrouted TO one or more of the following:

Modules/Macros

  • DSM      DSMC
    

Fix information

  • Fixed component name

    TSM CLIENT

  • Fixed component ID

    5698ISMCL

Applicable component levels

  • R81W PSY

       UP



Document information

More support for: Tivoli Storage Manager

Software version: 71W

Reference #: IT19057

Modified date: 16 March 2017