IBM Support

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

Subscribe

You can track all active APARs for this component.

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



Document information

More support for: Tivoli Storage Manager

Software version: 71W

Reference #: IT21983

Modified date: 27 September 2017