IT03300: SYSTEMSTATE RESTORE FAILS IF USING TESTFLAG REPLACEROSHORTNAME REMOVESHORTDIRNAMEONCREATE

IBM Tivoli Storage Manager (TSM) Client 7.1.2 Downloads and READMEs

APAR status

• Closed as program error.

Error description

• Error Description:
  Using TESTFLAG REPLACEROSHORTNAME REMOVESHORTDIRNAMEONCREATE
  mentioned in APAR IC85497 generates errors and interrupts
  systemstate restore prematurely.
  
  Customer/L2 Diagnostics:
  
  It has been identified that systemstate backup does not back up
  the short names for directories and thus they cannot be properly
  restored
  
  Performing a restore systemstate with enabled the testflags
  REPLACEROSHORTNAME REMOVESHORTDIRNAMEONCREATE mentioned in APAR
  IC85497 have as results a failed restore and a corrupted
  systemstate,.
  
  The following message is issued multiple times:
  
  ANS1796I The short name for 'X:\windows\TEMP\~adsm.sys\Program
  Files\tivoli\tsm\baclient\adsm.sys\VSS_STAGING' could not be set
  to original short name '': Windows function 'SetFileShortName'
  failed with return code 87, reason: 'The parameter is
  incorrect.'
  
  This is cause because systemstate restore in WinPE mode does not
  restore short names due to an issue with the target path name
  using GUID rather than UNC name.
  
  Tivoli Storage Manager Versions Affected: All Tivoli Storage
  Manager  client  v6.x  and 7.1  on Windows  Platforms.
  
  
  Initial Impact: medium
  
  Additional Keywords: REPLACEROSHORTNAME
  REMOVESHORTDIRNAMEONCREATE IC85497 systemstate ANS1796I
  

Local fix

• Local Fix:
  None
  

Problem summary

• ****************************************************************
  * USERS AFFECTED:                                              *
  * Backup-archive client versions 5.4, 5.5, 6.1, 6.2, 6.3, 6.4  *
  * and 7.1 running on the Windows platforms                     *
  ****************************************************************
  * PROBLEM DESCRIPTION:                                         *
  * See ERROR DESCRIPTION.                                       *
  ****************************************************************
  * RECOMMENDATION:                                              *
  * Apply fixing level when available. This problem is currently *
  *                                                              *
  * projected to be fixed in level 7.1.2. Note that this is      *
  * subject                                                      *
  * to change at the discretion of IBM.                          *
  ****************************************************************
  *
  

Problem conclusion

• To avoid running into the problem users can specify these
  testflags:
     "TESTFLAG REPLACEROSHORTNAME REMOVESHORTDIRNAMEONCREATE"
  
  IBM will consider making this the default behavior in a future
  release or maintenance level.
  

Temporary fix

Comments

APAR Information

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

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

Modules/Macros

• DSM      DSMC     DSMCSVC  DSMAGENT
  

Fix information

• Fixed component name

  TSM CLIENT

• Fixed component ID

  5698ISMCL

Applicable component levels

• R63W PSY

     UP

• R64W PSY

     UP

• R71W PSY

     UP