IBM Support

IT22377: UNEXPECTED PATHS FOR FILE(S) IN DSMERROR.LOG FOR FILESET SNAPSHOT BASED BACKUP

Subscribe

You can track all active APARs for this component.

APAR status

  • Closed as program error.

Error description

  • When performing a fileset snapshot based backups of IBM Spectrum
    Scale
     using "mmbackup", as in the following example command:
    
    /usr/lpp/mmfs/bin/mmbackup /fs1/fileset_name   -S
    mm_backup_snapshot_fileset_name --tsm-servers sp201 --scope
    inodespace -N ces --backup-threads 7 --max-backup-size 1048576
    --max-backup-count 65000 --expire-threads 7 --max-expire-count
    65000 -a
    10 --noquote
    
    As can be seen, mmbackup is invoked on fileset
    /fs1/fileset_name and not on filesystem /fs1.
    
    Now suppose there is a file with a special character "file?.txt"
    within that
    fileset:
    
    /fs1/fileset_name/file?.txt
    
    During backup, the error will be seen:
    
    ANS4005E Error processing '/fs1/file?.txt': file not found
    
    Instead of:
    
    ANS4005E Error processing '/fs1/fileset_name/file?.txt': file
    not found
    
    Despite the above incorrect path being displayed, the actual
    expected filepath will correctly be stored on the IBM Spectrum
    Protect server :
    
    dsmc query backup  /fs1/fileset_name/file?.txt
    Size  Backup Date  Mgmt Class  A/I File
    ----  -----------  ----------  --- ---------------------------
    xx B  <timestamp>  DEFAULT      A  /fs1/fileset_name/file?.txt
    
    Initial Impact: Medium
    
    
    Tivoli Storage Manager Versions Affected:
    7.1.x and 8.1.xTivoli Storage Manager Client on all supported
    platforms that support IBM Spectrum Scale
    
    
    
    
    
    Additional Keywords:  TSM  Spectrum Protect backup message
    incorrect path
    

Local fix

Problem summary

  • ****************************************************************
    * USERS AFFECTED:                                              *
    * Backup-archive client versions 7.1.6, 8.1.0 and 8.1.2        *
    * running on all UNIX GPFS 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 problem occurs if performing selective or incremental GPFS
    fileset snapshot  backup using -filelist and -snapshotroot
    options from command line.
    If the filelist contains files which can not be backed up for
    any reason, the wrong path is displayed.
    After the fix, the correct path will be displayed.
    

Temporary fix

Comments

APAR Information

  • APAR number

    IT22377

  • Reported component name

    TSM CLIENT

  • Reported component ID

    5698ISMCL

  • Reported release

    71L

  • Status

    CLOSED PER

  • PE

    NoPE

  • HIPER

    NoHIPER

  • Special Attention

    NoSpecatt / Xsystem

  • Submitted date

    2017-09-13

  • Closed date

    2017-10-17

  • Last modified date

    2017-12-06

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

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

Modules/Macros

  • dsmc
    

Fix information

  • Fixed component name

    TSM CLIENT

  • Fixed component ID

    5698ISMCL

Applicable component levels

  • R81L PSY

       UP

  • R81A PSY

       UP



Document information

More support for: Tivoli Storage Manager

Software version: 71L

Reference #: IT22377

Modified date: 06 December 2017