IC91003: HSM FOR WINDOWS PLUGIN FAILS TO READ STUB CONTENT FROM SHADOW COPY OF THE LOCAL DISK DURING B/A CLIENT SNAPSHOT BASED BACKUP.

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

APAR status

• Closed as program error.

Error description

• On systems with Tivoli Storage Manager Backup/Archive Client
  and Tivoli Storage Manager HSM for Windows installed, the B/A
  client fails to backup migrated files if snapshot based backup
  is being used.
  To check if a HSM stub file needs to be backed up, the B/A
  client needs to calculate the reparse point CRC of the stub
  located on the local shadow copy volume and compare it with the
  CRC of the stub stored on the Tivoli Storage Manager server.
  This operation may fail due to the HSM plugin not being able to
  read the stub content from the shadow copy of the local disk.
  
  TSM Versions Affected:
  Tivoli Storage Manager HSM for Windows versions
  6.3.0.0 - 6.3.1.0, 6.4.0.0
  
  Customer/L2 Diagnostics:
  The B/A client dsmerror.log shows the following errors:
  ************
  ANS27063E Failure sending file data of <path>\file
  ************
  The HSM plugin trace will show the following messages:
  ************
  DSMC (1DB8:1CAC) piCalcReparsePointCRC
   T: Starting piCalcReparsePointCRC for file '<path>\file'.
  DSMC (1DB8:1CAC) piCalcReparsePointCRC
   D: Starting stub reading for file '<path>\file'.
  DSMC (1DB8:1CAC) ICReparsePoint::mf_implGet::2
   E: Failure opening file '<path>\file':
      Errno-value:    0x03000029 (E: File open error)
      Originator:     System, error code 5L (0x00000005L): Access
  is denied.
  DSMC (1DB8:1CAC) ICReparsePoint::mf_getRawData
   E: Failure reading reparse data from file <path>\file
      Errno-value:    0x03000029 (E: File open error)
      Originator:     System, error code 5L (0x00000005L): Access
  is denied.
  DSMC (1DB8:1CAC) piCalcReparsePointCRC
   E: Failure calculating checksum for reparse data:
      Errno-value:    0x03000029 (E: File open error)
      Originator:     System, error code 5L (0x00000005L): Access
  is denied.
  ************
  Tivoli Storage Manager Versions Affected:
  Tivoli Storage Manager HSM for Windows 6.3.0.0 and later on all
  supported Windows platforms
  
  Initial Impact:
  Medium
  
  Additional Keywords:
  zztsm63 HSM TSM
  

Local fix

• - Use option checkreparsecontent=no
  or
  - use ordinary backup instead of snapshot based backup
  

Problem summary

• ****************************************************************
  * USERS AFFECTED: Version 6.3 and 6.4 backup-archive client    *
  *                 on Windows platform processing an HSM        *
  *                 managed volume.                              *
  ****************************************************************
  * PROBLEM DESCRIPTION: See ERROR DESCRIPTION.                  *
  ****************************************************************
  * RECOMMENDATION: Apply fixing level when available. This      *
  *                 problem is currently projected to be fixed   *
  *                 in levels 6.4.1 and 6.3.2. Note that until   *
  *                 these levels are available, this             *
  *                 information is subject to change at the      *
  *                 discretion of IBM.                           *
  ****************************************************************
  

Problem conclusion

• The problem has been fixed.
  

Temporary fix

• see local fix
  

Comments

APAR Information

• 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

• R63W PSY

     UP

• R64W PSY

     UP