IBM Support

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

Subscribe

You can track all active APARs for this component.

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 number

    IT22038

  • Reported component name

    TSM CLIENT

  • Reported component ID

    5698ISMCL

  • Reported release

    64W

  • Status

    CLOSED PER

  • PE

    NoPE

  • HIPER

    NoHIPER

  • Special Attention

    NoSpecatt / Xsystem

  • Submitted date

    2017-08-25

  • Closed date

    2017-10-20

  • Last modified date

    2017-10-20

  • 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



Document information

More support for: Tivoli Storage Manager

Software version: 64W

Reference #: IT22038

Modified date: 20 October 2017