IBM Support

IT20015: SNAPDIFF BACKUP FAILS WITH ANS1626E WHEN SPECIFYING UNC PATH IN STAGINGDIRECTORY OPTION

Subscribe

You can track all active APARs for this component.

APAR status

  • Closed as program error.

Error description

  • Error Description: In IBM Spectrum Protect client the snapdiff
    backup fails when specifying an UNC path in the stagingdirectory
     option.
    
    For example the following command:
    
    dsmc incr  \\mytestmachine\vol_cifs1_migr$ -optfile=dsm.opt
    -stagingdir="\\ mytestmachine \c$\vol\udmfi4\" -node=my_node
    -snapdiff
    
    will fail with the following error reported in dsmerror.log:
    
    ANS1626E An unexpected error was encountered when processing a
    TSM operation using a hardware or snapshot function.
       TSM function name : NAHWInterface::naPerformSnapDiff
       TSM function      : Snapdiff DB initialization failed
       TSM return code   : -1
       TSM file          : ..\..\common\hci\NAHWInterface.cpp (4404)
    ANS5250E An unexpected error was encountered.
       TSM function name : baPerformSnapDiff
       TSM function      : failed to perform snapdiff
       TSM return code   : 653
       TSM file          : ..\..\common\ba\backsnap.cpp (6132)
    ANS2832E Incremental by snapshot difference failed for \\
    mytestmachine \vol_cifs1_migr$.
    See the error log for details.
    ANS1228E Sending of object '\\
    mytestmachine.sum.local\vol_cifs1_migr$' failed.
    The operation was unsuccessful.
    
    IBM Spectrum Protect Versions Affected: IBM Spectrum Protect
    Client v7.1.x and v8.1.x
    
    Initial Impact: Low
    
    Additional Keywords: ANS1626E ANS5250E ANS2832E Snapdiff DB
    initialization failed 653
    

Local fix

  • Local Fix :
    Map the UNC path to a drive letter.
    
    For example:
    
    NET USE K: \\ mytestmachine\c$\vol\udmfi4\ /U: local\appbck *
    
    and use the assigned letter in the value for the
    stagingdirectory option:
    
    dsmc incr \\ mytestmachine\vol_cifs1_migr$ -optfile=dsm.opt
    -stagingdir=K: -node=mynode -snapdiff
    

Problem summary

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

Problem conclusion

  • The problem when the client incorrectly parses the path
    specified in the UNC format has been fixed so that it no longer
    occurs.
    Note, that the problem also affects few client options
    (dedupcachepath, diskcachelocation and others) connected with
    the path setting.
    

Temporary fix

Comments

APAR Information

  • APAR number

    IT20015

  • 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-04-03

  • Closed date

    2017-05-05

  • Last modified date

    2017-05-05

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

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

Modules/Macros

  • dsmc
    

Fix information

  • Fixed component name

    TSM CLIENT

  • Fixed component ID

    5698ISMCL

Applicable component levels

  • R71W PSY

       UP

  • R81W PSY

       UP



Document information

More support for: Tivoli Storage Manager

Software version: 71W

Reference #: IT20015

Modified date: 05 May 2017