IT22038: CLIENT MAY GIVE "RC 0" WHEN A FILE COULD NOT BE DELETED DURING ARCHIVE PROCESSING WITH "-DELETEFILES" OPTION

IBM Spectrum Protectâ„¢ Client 8.1.4 Downloads and READMEs
IBM Spectrum Protect client 7.1.8.x interim fix downloads

APAR status

• Closed as program error.

Error description

• When running an 'ARCHIVE' command using the "-DELETEFILES"
  option, the session can end with Return Code of 0 when files are
   not deleted from the client.   This can happen if the files are
   locked so cannot be deleted.  This Return Code says that the
  operation was Successful but we see a message saying the delete
  was Unsuccessful.
  
  For example:-
  
  DSMC ARCHIVE "\\dir\test.txt"   -deletefiles
  
  tsm> ARCHIVE -ARCHMC=standard -deletefiles
  "D:\_tsm_test_files\ha.4.xml"
  Archive function invoked.
  
  Normal File-->               579
  \\kelt3\d$\_tsm_test_files\ha.4.xml [Sent]
  Unsuccessful deletion of archived file
  \\kelt3\d$\_tsm_test_files\ha.4.xml
  Archive processing of '\\kelt3\d$\_tsm_test_files\ha.4.xml'
  finished without failure.
  
  Using the command "echo %errorlevel%"  gives a '0'
  
  This should end with a Return Code of 8 - "The operation
  completed with at least one warning message"
  
  IBM Spectrum Protect versions Affected: All supported versions -
  6.4, 7.1 and 8.1 on all platforms
  
  Initial Impact: Low
  
  Additional Keywords: TSM Tivoli Storage Manager RC  IC85600
  Spectrum Protect ISP
  
  | MDVREGR 6.4.0.0-TIV_5698MSV |
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED:                                              *
  * IBM Tivoli Storage Manager Backup-Archive client Version 6.4 *
  * running on all platforms                                     *
  * IBM Spectrum Protect Backup-Archive client Version 7.1,      *
  * 8.1.0 and 8.1.2  running on all platforms                    *
  ****************************************************************
  * PROBLEM DESCRIPTION:                                         *
  * See ERROR DESCRIPTION                                        *
  ****************************************************************
  * RECOMMENDATION:                                              *
  * Apply fixing level when available. This problem is currently *
  * projected to be fixed in levels  7.1.8, and 8.1.4.  Note     *
  * that until these levels are available, this information is   *
  * subject to change at the discretion of IBM.                  *
  ****************************************************************
  *
  

Problem conclusion

• If a file is locked during processing, an attempt to delete that
  file will fail and a message wil be reported. However, the
  return code of the dsmc executable will report successful
  execution via RC_OK (0). The code has been changed to display
  new warning message and more appropriate return code (8).
  

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

• dsmc
  

Fix information

• Fixed component name

  TSM CLIENT

• Fixed component ID

  5698ISMCL

Applicable component levels

• R71A PSY

     UP

• R71L PSY

     UP

• R71M PSY

     UP

• R71S PSY

     UP

• R71W PSY

     UP

• R81A PSY

     UP

• R81L PSY

     UP

• R81M PSY

     UP

• R81S PSY

     UP

• R81W PSY

     UP