IBM Support

IT20941: ERROR ANS4174E RC=-1 WHEN TRAILING CHARACTER IN THE GUEST NAME IS '.' (PERIOD)

Subscribe

You can track all active APARs for this component.

 

APAR status

  • Closed as program error.

Error description

  • When a VMware guest name is ending with a '.' (period), the
    'Backup VM' command will fail at the end of the backup in the
    local staging directory cleanup phase with the following errors
    seen in the data mover node's dsmerror.log :
    
    As many messages as there are megablocks representing the VM
    guest the following one :
    
    ANS5250E An unexpected error was encountered.
       IBM Spectrum Protect function name : vcmLogger::trace
       IBM Spectrum Protect function      :
    CacheManager::remove_element: Failed to save element: Path:
    'C:\mnt\tsmvmbackup\fullvm\CDF_Local\vmname.\Hard Disk 1' Job:
    1001  MB Number: <xxx>
       IBM Spectrum Protect return code   : 115
       IBM Spectrum Protect file
    :..\..\common\vm\vmbackvcm.cpp(218)
    
    (where "xxx" corresponds to the number of the megablock)
    
    then
    
    ANS5250E An unexpected error was encountered.
       IBM Spectrum Protect function name : vcmLogger::trace
       IBM Spectrum Protect function      :
    VolumeControl::write_bitmap: can't open file
    'C:\mnt\tsmvmbackup\fullvm\CDF_Local\vmname.\Hard Disk 1' for
    writing
       IBM Spectrum Protect return code   : 115
       IBM Spectrum Protect file
    :..\..\common\vm\vmbackvcm.cpp(218)
    ANS5250E An unexpected error was encountered.
       IBM Spectrum Protect function name : vcmLogger::trace
       IBM Spectrum Protect function      :
    VolumeControlManager::write_object: write_bitmap() failed
    (id='Path: 'C:\mnt\tsmvmbackup\fullvm\CDF_Local\vmname.\Hard
    Disk 1' Job: 1001')
       IBM Spectrum Protect return code   : 115
       IBM Spectrum Protect file
    :..\..\common\vm\vmbackvcm.cpp(218)
    ANS5250E An unexpected error was encountered.
       IBM Spectrum Protect function name : vcmLogger::trace
       IBM Spectrum Protect function      :
    CacheManager::remove_element: Failed to save element: Path:
    'C:\mnt\tsmvmbackup\fullvm\CDF_Local\vmname.\Hard Disk 1' Job:
    1001
       IBM Spectrum Protect return code   : 115
       IBM Spectrum Protect file
    :..\..\common\vm\vmbackvcm.cpp(218)
    ANS5250E An unexpected error was encountered.
       IBM Spectrum Protect function name : vcmLogger::trace
       IBM Spectrum Protect function      :
    VolumeControlManager::get_first_valid_megablock_in_volume:
    get_elemnt from cache failed (id='Path:
    'C:\mnt\tsmvmbackup\fullvm\CDF_Local\vmname.
           \Hard Disk 1' Job: 1001')
       IBM Spectrum Protect return code   : 115
       IBM Spectrum Protect file
    :..\..\common\vm\vmbackvcm.cpp(218)
    ANS0361I DIAG: VmBackupControlFiles(): Error -1 in access vcm
    lib to get the list of ctl's
    ANS5250E An unexpected error was encountered.
       IBM Spectrum Protect function name : vcmLogger::trace
       IBM Spectrum Protect function      :
    VolumeControlManager::remove_volume_from_cache: Volume not in
    cache, nothing to remove (id='Path:
    'C:\mnt\tsmvmbackup\fullvm\CDF_Local\vmname.\Hard Disk 1' Job:
    1001')
       IBM Spectrum Protect return code   : 115
       IBM Spectrum Protect file
    :..\..\common\vm\vmbackvcm.cpp(218)
    ANS4174E Full VM backup of VMware Virtual Machine 'vmname.'
    failed with RC=-1 mode=Incremental Forever - Full, target node
    name='<datacenter node>', data mover node name='<datac mover
    node>'
    
    Products affected:
    IBM Spectrum Protect for Virtual Environments: Data Protection
    for VMware version 8.1 on Windows x64 and Linux x86_64
    platforms.
    
    This problem also affects IBM Spectrum Protect Backup-Archive
    Client which is the data mover for Data Protection for
    VMware 7.1. If you are using Data Protection for VMware
    7.1 refer to APAR IT24006.
    
    Initial Impact: Medium
    
    Additional Keywords: tsm4ve tdp4ve backup vm internal error
    

Local fix

  • Rename the guest to avoid the trailing '.' (period) character
    and retry the backup
    

Problem summary

  • ****************************************************************
    * USERS AFFECTED:                                              *
    * Data Protection for VMware Data Mover versions 7.1 and 8.1   *
    * running on all on Windows x64 and Linux x86_64 platforms     *
    ****************************************************************
    * PROBLEM DESCRIPTION:                                         *
    * See ERROR DESCRIPTION                                        *
    ****************************************************************
    * RECOMMENDATION:                                              *
    * This issue is projected to be fixed in the Data Protection   *
    * for VMware Data Mover version 8.1.4 on Windows x64 and Linux *
    * x86_64 platforms.                                            *
    * Note 1: This is subject to change at the discretion of IBM.  *
    ****************************************************************
    

Problem conclusion

  • Now client displays the message that the VM names end with a
    period is not supported.
    

Temporary fix

Comments

APAR Information

  • APAR number

    IT20941

  • Reported component name

    TSM CLIENT

  • Reported component ID

    5698ISMCL

  • Reported release

    81W

  • Status

    CLOSED PER

  • PE

    NoPE

  • HIPER

    NoHIPER

  • Special Attention

    NoSpecatt / Xsystem

  • Submitted date

    2017-06-08

  • Closed date

    2018-02-11

  • Last modified date

    2018-02-11

  • APAR is sysrouted FROM one or more of the following:

  • APAR is sysrouted TO one or more of the following:

    IT24006 IT24019

Modules/Macros

  • dsmc
    

Fix information

  • Fixed component name

    TSM FOR VE DP V

  • Fixed component ID

    5725TVEVM

Applicable component levels

  • R81W PSY

       UP

  • R81L PSY

       UP

[{"Business Unit":{"code":"BU058","label":"IBM Infrastructure w\/TPS"},"Product":{"code":"SS8TDQ","label":"Tivoli Storage Manager for Virtual Environments"},"Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"81W","Line of Business":{"code":"LOB26","label":"Storage"}}]

Document Information

Modified date:
07 January 2022