IBM Support

IC98339: FIX VSS WRITER TO GATHER VOLUMES FOR VSS BACKUP WITHOUT ERRORS WHEN CRISTIE TBMR RUNS AND SKIP RAMDISK VOLUMES

Subscribe

You can track all active APARs for this component.

APAR status

  • Closed as program error.

Error description

  • 1) When the Cristie Bare Machine Recovery for TSM (TBMR)
    Configuration Tool (TbmrCfg.exe) is running and has already
    collected system configuration, VSS backup operations for:
    
    - Tivoli Storage Manager (TSM) Client
    - Tivoli Storage Manager (TSM)  for Databases: Data Protection
      for Microsoft SQL Server
    - Tivoli Storage Manager (TSM)  for Mail: Data Protection for
      Microsoft Exchange Server
    - Tivoli Storage FlashCopy Manager on Windows
    
    may fail with the following message:
    
    ANS5250E An unexpected error was encountered.
    TSM function name : CTsmVssWriterThread:
    :GatherBackupableVolumesInfo
    TSM function : CTsmVssWriterThread:
    :GatherBackupableVolumesInfo(): Failed to gather information
    about mounted system volumes on hard disk drives.
    psGetVssEligibleVolumes() failed rc='87'
    TSM return code : 87
    TSM file : ..\..\common\winnt\vssTsmVssWriterThread.cpp (269)
    
    A client service trace will show messages similar to:
    
    23.10.2013 06:32:01.368 [014156] [19896] :
    ..\..\common\winnt\psfsinfo.cpp(1595): fioStatFS(): File
    system 'E:\': Name      = System
    23.10.2013 06:32:01.368 [014156] [19896] :
    ..\..\common\winnt\psfsinfo.cpp(1597): fioStatFS():
            Type      = NTFS
    23.10.2013 06:32:01.368 [014156] [19896] :
    ..\..\common\winnt\psfsinfo.cpp(1599): fioStatFS():
            Remote    = No
    23.10.2013 06:32:01.368 [014156] [19896] :
    ..\..\common\winnt\psfsinfo.cpp(1601): fioStatFS():
            Removable = No
    23.10.2013 06:32:01.368 [014156] [19896] :
    ..\..\common\winnt\psfsinfo.cpp(1603): fioStatFS():
            Cluster   = No
    23.10.2013 06:32:01.368 [014156] [19896] :
    ..\..\common\winnt\psfsinfo.cpp(1605): fioStatFS():
            RAM       = Yes
    23.10.2013 06:32:01.368 [014156] [19896] :
    ..\..\common\winnt\psfsinfo.cpp(1720): GetDosDevTrueName()
    called. INPUT drv = 'E:\'
    23.10.2013 06:32:01.368 [014156] [19896] :
    ..\..\common\winnt\psfsinfo.cpp(1794): GetDosDevTrueName():
    Querying DOS Device name for szDosDevName = 'E:' ...
    23.10.2013 06:32:01.369 [014156] [19896] :
    ..\..\common\winnt\psfsinfo.cpp(1801): GetDosDevTrueName():
    Dos Device name is
    '\??\GLOBALROOT\Device\HarddiskVolumeShadowCopy915'
    23.10.2013 06:32:01.369 [014156] [19896] :
    ..\..\common\winnt\psfsinfo.cpp(1828): GetDosDevTrueName():
    Drive is a SUBSTed drive, the path is
    'GLOBALROOT\Device\HarddiskVolumeShadowCopy915'
    23.10.2013 06:32:01.369 [014156] [19896] :
    ..\..\common\winnt\psfsinfo.cpp(4695):
    psGetVssEligibleVolumes(): fsGetNextFileSpace returns
    fsVolumeName = 'E:'
    23.10.2013 06:32:01.369 [014156] [19896] :
    ..\..\common\winnt\psfsinfo.cpp(4755):
    psGetVssEligibleVolumes(): fsStatInfo.fsFlags is '32440575'
    23.10.2013 06:32:01.369 [014156] [19896] :
    ..\..\common\winnt\psfsinfo.cpp(4756):
    psGetVssEligibleVolumes(): FILE_SUPPORTS_REPARSE_POINTS is '128'
    23.10.2013 06:32:01.369 [014156] [19896] :
    ..\..\common\winnt\psfsinfo.cpp(4990):
    psGetVssEligibleVolumes() exits rc='87'
    23.10.2013 06:32:01.369 [014156] [19896] :
    ..\..\common\winnt\vssTsmVssWriterThread.cpp( 254):
    CTsmVssWriterThread::GatherBackupableVolumesInfo():
    psGetVssEligibleVolumes returned rc='87'
    23.10.2013 06:32:01.371 [014156] [19896] :
    ..\..\common\winnt\vssTsmVssWriterThread.cpp( 272): ANS5250E
    Es wurde ein unerwarteter Fehler festgestellt.
       TSM-Funktionsname :
    CTsmVssWriterThread::GatherBackupableVolumesInfo
       TSM-Funktion      :
    CTsmVssWriterThread::GatherBackupableVolumesInfo(): Failed to
    gather information about mounted system volumes on hard disk
    drives. psGetVssEligibleVolumes() failed rc='87'
    
       TSM-R ckkehrcode  : 87
       TSM-Datei         :
    ..\..\common\winnt\vssTsmVssWriterThread.cpp (269)
    23.10.2013 06:32:01.371 [014156] [19896] :
    ..\..\common\winnt\vssTsmVssWriterThread.cpp( 278):
    CTsmVssWriterThread::GatherBackupableVolumesInfo() exits rc='87'
    23.10.2013 06:32:01.371 [014156] [19896] :
    ..\..\diagent\agent\diqry.cpp(6118): diVSSQryComponents():
    tvwThreadP->GatherBackupableVolumesInfo() failed rc='87'
    
    
    2) When a RAM disk is present on the system VSS query
    components and VSS backup operations will fail instead of
    skipping the RAM disk. For example, in the case of a Tivoli
    Storage FlashCopy Manager on Windows query operations fail
    with:
    
    
    fcmcli q comp
    
    FlashCopy Manager for Windows:
    IBM Tivoli Storage FlashCopy Manager
    Version 3, Release 2, Level 1.0
    (C) Copyright IBM Corporation 2009, 2013. All rights reserved.
    
    Querying components, please wait...
    
    Connecting to FCM Server as node 'WIN-KUAH1GHQT1G_FS'...
    Connecting to Local DSM Agent 'WIN-KUAH1GHQT1G'...
    Using backup node 'WIN-KUAH1GHQT1G_FS'...
    Querying VSS Information, please wait...
    
    FMF6018E FlashCopy Manager was not able to obtain VSS
    component information.
    
    
    FMV1302E (RC2)    No objects on server match query
    
    TSM Client error log (dsmerror.log) contains:
    
    12/24/2013 12:17:36 FMV5250E An unexpected error was
    encountered.
       FCM function name : psGetVssEligibleVolumes
       FCM function      : setShadowCopyVolume failed rc = '6213'
    
       FCM return code   : 6213
       FCM file          : ..\..\common\winnt\psfsinfo.cpp (4971)
    12/24/2013 12:17:36 FMV5250E An unexpected error was
    encountered.
       FCM function name :
    CTsmVssWriterThread::GatherBackupableVolumesInfo
       FCM function      :
    CTsmVssWriterThread::GatherBackupableVolumesInfo(): Failed to
    gather information about mounted system volumes on hard disk
    drives. psGetVssEligibleVolumes() failed rc='6213'
    
       FCM return code   : 6213
       FCM file          :
    ..\..\common\winnt\vssTsmVssWriterThread.cpp (269)
    
    
    
    
    Tivoli Storage Manager (TSM) client versions affected:
    6.3, 6.4, 7.1
    Other Affected Products:
    The following products are affected because the TSM
    Client is used for their VSS operations:
    
    - Tivoli Storage Manager for Mail: Data Protection for
      Microsoft Exchange Server
    - Tivoli Storage Manager for Databases: Data Protection for
      Microsoft SQL Server
    - Tivoli Storage FlashCopy Manager for Windows.
    
    Initial Impact: High
    
    Additional Keywords:
    tsm dsmagent localdsmagent dsmcad baclient tdpsql tdpexc
    

Local fix

  • Before performing a VSS query components or VSS backup using
    one of the affected products you have to temporarily disable
    either of the following depending on the conditions:
     -- the Cristie TBMR configuration tool (TbmrCfg.exe), or,
        respective,
     -- the RAM disk.
    
    Note: After disabling those items you might need rescan
    disks, or refresh the volumes system info using mountvol /R
    command.
    

Problem summary

  • ****************************************************************
    * USERS AFFECTED: Users of the Tivoli Storage Manager (TSM)    *
    *                 client 6.3, 6.4, 7.1 on Windows platforms,   *
    *                                                              *
    *                 and                                          *
    *                                                              *
    *                 Users of the following products which are    *
    *                 affected because the TSM Client is used      *
    *                 for their VSS operations:                    *
    *                 - Tivoli Storage Manager for Mail: Data      *
    *                 Protection for Microsoft Exchange Server     *
    *                 - Tivoli Storage Manager for Databases:      *
    *                 Data Protection for Microsoft SQL Server     *
    *                 - Tivoli Storage FlashCopy Manager for       *
    *                 Windows.                                     *
    *                                                              *
    *                 Users having either:                         *
    *                 - Cristie TBMR configuration tool running    *
    *                 - RAM disk installed on the server           *
    ****************************************************************
    * PROBLEM DESCRIPTION: FMV5250E An unexpected error was        *
    *                      encountered.                            *
    *                         FCM function name :                  *
    *                      psGetVssEligibleVolumes                 *
    *                         FCM function      :                  *
    *                      setShadowCopyVolume failed rc = '6213'  *
    *                                                              *
    *                         FCM return code   : 6213             *
    *                         FCM file          :                  *
    *                      ..\..\common\winnt\psfsinfo.cpp (4971)  *
    ****************************************************************
    * RECOMMENDATION:Apply the 6.4.2 or 7.1.1 fixing levels.       *
    ****************************************************************
    *
    

Problem conclusion

  • The Tivoli Storage Manager Client has been updated to fix the
    TSM VSS Writer for file systems to get the volumes that can be
    VSS backed up.
    

Temporary fix

  • 6.3.2.4 interim fix
    

Comments

APAR Information

  • APAR number

    IC98339

  • Reported component name

    TSM CLIENT

  • Reported component ID

    5698ISMCL

  • Reported release

    64W

  • Status

    CLOSED PER

  • PE

    NoPE

  • HIPER

    NoHIPER

  • Special Attention

    NoSpecatt

  • Submitted date

    2013-12-16

  • Closed date

    2014-01-27

  • Last modified date

    2015-04-23

  • 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

  • R71W PSY

       UP



Document information

More support for: Tivoli Storage Manager

Software version: 64W

Reference #: IC98339

Modified date: 23 April 2015