IT21983: IBM SPECTRUM PROTECT CLIENT CAN CRASH ON WINDOWS IF MICROSOFT SYSTEM PARTITION HAS A PATH NAME EQUAL OR GREATHER THAN 49 CHARS

IBM Spectrum Protectâ„¢ Client 8.1.4 Downloads and READMEs
IBM Spectrum Protect client 7.1.8.x interim fix downloads

APAR status

• Closed as program error.

Error description

• Error Description: IBM Spectrum Protect  Client on Windows
  platforms may crash when the Microsoft System Partition (MSP)
  has a path name with 49 or more characters.
  
  The stack trace will show:
  
  dsmagent!StrCat+0x29
  dsmagent!copyFileVss2Tsm+0x293
  dsmagent!copyFileVss2Tsm+0x86
  dsmagent!VssRequestor::VssQuerySystemWriters+0x78c
  dsmagent!psQuerySystemWriters+0x6a
  dsmagent!StartExclVssFileScan+0x3c
  dsmagent!psGetSystemExcludeList+0x217
  
  The crash may occur both when starting the Client via graphical
  interface (GUI) and by command line.
  
  
  
  
  Customer/L2 Diagnostics:
  
  At boot time the Microsoft System Reserved partition (the MSR
  partition is required to boot Windows 7 and later operating
  systems. Ordinarily, this partition does not have a drive letter
  assigned to it.)
  '\\?\Volume{35cf8da2-a9bf-11e3-80b5-806e6f6e6963}' is mapped to
  "C:\$RVMPMA9\" and then this folder is deleted.
  
  So from OS point of view MSR is mapped to
  'C:\$Recycle.Bin\S-1-5-21-3810995815-895729110-3936516981-50009\
  $RVMPMA9\'.
  
  A Spectrum Protect B/A Client service trace will show:
  ...
  08/04/2017 11:16:14.707 [045244] [37580] :
  ..\..\common\winnt\vssreq.cpp(13511): copyFileVss2Tsm():
  GetVolumePathNamesForVolumeName(\\?\Volume{35cf8da2-a9bf-11e3-80
  b5-806e6f6e6963}\) returned
  drivePath='C:\$Recycle.Bin\S-1-5-21-3810995815-895729110-3936516
  981-50009\$RVMPMA9\', returnLength=220
  ...
  
  The crash occurs when MSR partition is mapped to a path of 49
  (or more) chars long.
  
  In some cases  MSR is mapped to
  C:\$Recycle.Bin\S-1-5-21-3810995815-895729110-3936516981-50009\$
  RVMPMA9\. That length of path is 72 chars and the client fails
  to handle it.
  
  Emptying the Recycle Bin does not help in this case.
  
  Tivoli Storage Manager Versions Affected: All IBM Spectrum
  protect Client v7.1 and 8.1 on Windows Platforms
  
  Initial Impact: Low
  
  Additional Keywords: Microsoft reserved partition
  GetVolumePathNamesForVolumeName copyFileVss2Tsm dsmagent!StrCat
  crash dsmc gui
  
  Local Fix:  None
  

Local fix

• Remove the mount point using the Windows Disk Manager
  

Problem summary

• ****************************************************************
  * USERS AFFECTED:                                              *
  * Backup-archive clients versions 6.3.x - 8.1.2 running on all *
  * 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.4.                        *
  * Note that this is subject to change at the discretion of     *
  * IBM.                                                         *
  ****************************************************************
  

Problem conclusion

• The routine that converts path in GUID format into UNC format
  was unable to handlee Microsoft System Partition of 49 or more
  characters long. This routine has been modified to work with
  long names.
  

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
  

Fix information

• Fixed component name

  TSM CLIENT

• Fixed component ID

  5698ISMCL

Applicable component levels

• R81W PSY

     UP