IT33443: TAPE OPTIMIZED RECALL REMOVES ALL FILES IN THE .SPACEMAN/TAPEOPTIMIZEDRECALL SUBDIRECTORY.

APAR status

• Closed as program error.

Error description

• When using dsmrecall in tape optimized recall (TOR) mode, the
  necessary tape and file lists are generated in
  <Filesystem>/.SpaceMan/tapeOptimizedRecall/<Node ID>/<PID>/
  However at the end of the processing, the whole
  tapeOptimizedRecall directory will be recursively deleted.
  This means the data from other dsmrecall jobs running in
  parallel or any prepared tape optimized filelists generated via
  -prev parameter, also will be deleted.
  
  
  In order to recreate the issue run:
  1. dsmrecall with -prev several times and there will be multiple
  prepared filelists in the
  <Filesystem>/.SpaceMan/tapeOptimizedRecall/<Node ID>/ directory.
     Example : dsmrecall -prev -d -se=server -filelist=filelist
  /filesystem
  2. Run dsmrecall using one of the prepared collections
     Example : dsmrecall -d -se=server
  -filelist=filelist.ordered.collection /filesystem
  3. After the command completes, the
  <Filesystem>/.SpaceMan/tapeOptimizedRecall/ directory will be
  removed.
  
  
  A client service trace shows that TOR removes all files in the
  ".SpaceMan/tapeOptimizedRecall" when it is finished.
  
  <timestamp> [PID][TID] : TapeOptimizedRecall.cpp(1062):
  (TapeOptimizedRecall::removeFileListDir): let's remove(<fs
  name>/.SpaceMan/tapeOptimizedRecall) subdirectory.
  <timestamp> [PID][TID] : TapeOptimizedRecall.cpp(1052): EXIT
  <===== TapeOptimizedRecall::removeFileListDir
  
  IBM Spectrum Protect Versions Affected:
  IBM Spectrum Protect for Space Management Client for Unix and
  Linux 7.1.x and 8.1.x on all supported platforms
  
  
  Initial Impact:
  Medium
  
  Additional Keywords:
  Spectrum Protect TSM TS003816896  TOR tape optimized recall
  clean remove filelist
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED:                                              *
  * IBM Spectrum Protect client versions 7.1 and 8.1 on all      *
  * Linux and UNIX.                                              *
  ****************************************************************
  * PROBLEM DESCRIPTION:                                         *
  * see ERROR DESCRIPTION                                        *
  ****************************************************************
  * RECOMMENDATION:                                              *
  * Apply fixing level when available. This problem is projected *
  * to be fixed in level 7.1.8.10 and 8.1.11. Note that this is  *
  * subject to change at the discretion of IBM.                  *
  ****************************************************************
  

Problem conclusion

• Tape optimized recall process will not remove a list of files
  that are optimized for tape recalls and generated by ?PREView
  command
  

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:

Modules/Macros

• dsmrecal
  

Fix information

• Fixed component name

  TSM SPACE MGMT

• Fixed component ID

  5698HSMCL

Applicable component levels