IBM Support

IT19098: DIRECTORY-CONTAINER STGPOOL "REUSEDELAY" OPTION IS NOT HONORED FOR "MOVE CONTAINER" PROCESS OR DEFRAGMENTATION

Subscribe

You can track all active APARs for this component.

 

APAR status

  • Closed as program error.

Error description

  • If a  directory-container stgpool has a reusedelay option set
    higher than zero and a MOVE CONTAINER command is executed,
    the source container is removed  shortly after the end of the
    process instead of waiting for the whole reusedelay period.
    
    The same happens if an internal defragmentation is started
    automatically because defragmentation uses the MOVE CONTAINER
    function too.
    
    That may cause a problem  if a PIT DB restore needs to be done
    before the end of the reusedelay period as the containers
    removed by the MOVE CONTAINER / defragmentation processes will
    be unrecoverable.
    
    IBM Spectrum Protect Versions Affected:  Server Version 7.1.3
    and higher on all supported platforms
    
    Initial Impact: Medium
    
    Additional Keywords:    TSM delay volume storage pool
    

Local fix

Problem summary

  • ****************************************************************
    * USERS AFFECTED:                                              *
    * All Tivoli Storage Manager and IBM Spectrum Protect server   *
    * users.                                                       *
    ****************************************************************
    * PROBLEM DESCRIPTION:                                         *
    * See error description.                                       *
    ****************************************************************
    * RECOMMENDATION:                                              *
    * Apply fixing level when available. This problem is currently *
    * projected to be fixed in levels  7.1.8.0 and 8.1.2.0.  Note  *
    * that this is subject to change at the discretion of IBM.     *
    ****************************************************************
    This APAR fix will honor the directory container stgpool
    REUSEDELAY attribute to preserve the directory container file
    following a
     successful MOVE CONTAINER process until the REUSEDELAY period
    has elapsed.
    Prior to this APAR fix, the affected directory container was
    removed from the filesystem
    immediately following MOVE CONTAINER.   After applying this APAR
    fix,  the directory container will not be
     removed from the filesystem until the stgpool REUSEDELAY period
    has elapsed.
    The current default value for REUSEDELAY in a directory
    container stgppol is 1 day.  If you want to force the immediate
    deletion of the directory container following a successful MOVE
    CONTAINER process, then you can update the stgpool
    REUSEDELAY to 0 using the following command: UPDATE STGPOOL
    <poolname> REUSEDELAY=0.
    The directory container that was affected by the successful
    completion of any prior MOVE CONTAINER process
     will be removed from filesystem storage within a 30 minute
    window.  Once all of the pending directory containers are
    removed, you can update the REUSEDELAY attribute back to the
    previous value.
    

Problem conclusion

  • This problem was fixed.
    Affected platforms:  AIX, Solaris, Linux, and Windows.
    

Temporary fix

Comments

APAR Information

  • APAR number

    IT19098

  • Reported component name

    TSM SERVER

  • Reported component ID

    5698ISMSV

  • Reported release

    71A

  • Status

    CLOSED PER

  • PE

    NoPE

  • HIPER

    NoHIPER

  • Special Attention

    NoSpecatt / Xsystem

  • Submitted date

    2017-02-03

  • Closed date

    2017-04-11

  • Last modified date

    2017-04-11

  • 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 SERVER

  • Fixed component ID

    5698ISMSV

Applicable component levels

[{"Business Unit":{"code":"BU029","label":"Software"},"Product":{"code":"SSGSG7","label":"Tivoli Storage Manager"},"Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"7.1.3"}]

Document Information

Modified date:
01 September 2023