IT31031: ANS1228E AND ANS4005E MESSAGE ON BACKUP OR ARCHIVE WHEN THE '-FILELIST' OPTION CONTAINS REMOTE SHARE PATHS

APAR status

• Closed as program error.

Error description

• The backup or archive operation run with the IBM Spectrum
  Protect  backup-archive client can stop when the following
  conditions are met :
  - the SNAPSHOTPROVIDERFS is set to VSS - Starting at 8.1.8 the
  VSS is the default value for SNAPSHOTPROVIDERFS
  - the 'filelist' option points to a file that contains remote
  shares paths to be archived or backed up
  - the 'filelist' file is placed on a local drive
  
  The operation will fail in the following manner:
  
  Command used :
  dsmc.exe archive -filelist="C:\temp\filelist.txt"
  
  Messages:
  Preparing to backup ''\\network\share\' using 'VSS' snapshot.
  ANS1377W The client was unable to obtain a snapshot of
  '\\?\GLOBALROOT\Device\HarddiskVolumeShadowCopy459'. The
  operation will continue without snapshot support.
  ANS1228E Sending of object '\\network\share\file.txt' failed.
  ANS4005E Error processing '\\network\share\file.txt': file not
  found
  ANS1803E Archive processing of '\temp\filelist.txt' finished
  with failures.
  
  The SNAPSHOTPROVIDERFS can be specified in different ways:
  - Set the option in the client's options file (dsm.opt)
  - Specified on a cloptset on the IBM Spectrum Protect Server
  - Passed in from client command line (-snapshotproviderfs=vss)
  - Specified in a schedule definition on the IBM Spectrum Protect
  Server.
  
  Initial Impact: Low
  
  IBM Spectrum Protect versions affected:
  Client 7.1.x and 8.1.x on Windows platforms
  
  Keywords:
  
  TSM  TS002599518 UNC filelist SNAPSHOTPROVIDERFS VSS
  

Local fix

• There are 2 ways to bypass the problem:
  
  1- The Filelist file containing remote shares paths can be
  placed on a local disk if the client option SNAPSHOTPROVIDERFS
  is set to NONE.
  It can be done changing the client option on the client options
  file (dsm.opt) or including -snapshotproviderfs=none in the
  command line arguments.
  
  2- Place the filelist on the remote share. When backing up
  multiple remote share paths, you can place the filelist file in
  any remote share.
  

Problem summary

• ****************************************************************
  * USERS AFFECTED:                                              *
  * Backup-archive client versions 7.1 and 8.1 running on all    *
  * Microsoft Windows platforms.                                 *
  ****************************************************************
  * PROBLEM DESCRIPTION:                                         *
  * See ERROR DESCRIPTION                                        *
  ****************************************************************
  * RECOMMENDATION:                                              *
  * This issue is projected to be fixed in the Backup-Archive    *
  * Client version 8.1.10 on all Microsoft Windows platforms     *
  * Note that this is subject to change at the discretion of     *
  * IBM.                                                         *
  ****************************************************************
  

Problem conclusion

• The code has been fixed so the client will not try to create a
  snapshot for the remote share.
  

Temporary fix

Comments

APAR Information

• 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