Fixes are available
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 number
IT21983
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-08-11
Closed date
2017-09-27
Last modified date
2017-09-27
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
[{"Business Unit":{"code":"BU058","label":"IBM Infrastructure w\/TPS"},"Product":{"code":"SSGSG7","label":"Tivoli Storage Manager"},"Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"71W","Line of Business":{"code":"LOB26","label":"Storage"}}]
Document Information
Modified date:
07 January 2022