IBM Support

IC97453: QUERY STGPOOL ESTIMATED CAPACITY CAN BE UNDER-ESTIMATED WHEN MAX SCRATCH VALUE IS INVALID

Subscribe

You can track all active APARs for this component.

APAR status

  • Closed as program error.

Error description

  • The Tivoli Storage Manager QUERY STGPOOL command can
    significantly under-estimate the storage pool "Estimated
    Capacity" for pools using the FILE device class.  This skewing
    can occur when the following conditions are true:
    
    * The MAXSCRATCH value for the storage pool is in excess of
      the number of volumes possible within the pool for a given
      output location and the volume size.
    * There is a large (multi-terrabyte) reclamation backlog
      within the storage pool in question.
    
    For example, the storage pool can report the following
    estimated capacity via the QUERY STGPOOL command:
    
      tsm: SERVER1>q stgpool
    
      Storage         Device          Estimated       Pct
      Pool Name       Class Name       Capacity      Util
      -----------     ----------     ----------     -----
      FILE_POOL       FILE             49,248 G      67.4
    
    However, the operating system layer output reports that the
    dedicated filesystem used for this device class is 60,000 G.
    
    This is a reporting problem only and has no functional impact
    on data storage operations.
    
    Customer/L2 Diagnostics:
    Determine if the MAXSCRATCH setting for the storage pool is
    appropriate, based on the MAXSIZE value for the device class,
    and the amount of space within the destination filesystem for
    the file volumes.
    
    Utilize the following select statement to determine if a large
    reclamation backlog (in MB's) exists for the storage pool in
    question (replace STORAGE_POOL_NAME with the name of the
    storage pool):
    
      tsm: SERVER1>select sum(est_capacity_mb*pct_reclaim/100) as
                   "Reclaimable (MB)" from volumes where
                   stgpool_name='STORAGE_POOL_NAME'
    
    Initial Impact:
    Low
    
    Tivoli Storage Manager Versions Affected:
    All Tivoli Storage Manager server users
    
    Additional Keywords:
    TSM FILE STG STGP STGPOOL Q QUERY RECLAIM RECLAMATION ESTCAP
    ESTIMATED CAPACITY UNDER LOWER SMALLER CAP EST MAX SCRATCH
    

Local fix

  • Reducing the MAXSCRATCH value on the storage pool may cause the
    EstCap to more accurately reflect the estimated capacity of the
    pool.  Be sure to also confirm that reclamation is functioning
    properly and consider reducing the reclamation threshold to
    reclaim more space within the storage pool if appropriate.
    

Problem summary

  • ****************************************************************
    * USERS AFFECTED: All Tivoli Storage Manager server users.     *
    ****************************************************************
    * PROBLEM DESCRIPTION: See error description.                  *
    ****************************************************************
    * RECOMMENDATION: Apply fixing level when available. This      *
    *                 problem is currently projected to be fixed   *
    *                 in levels 6.3.5 and 7.1.1.                   *
    *                 Note that this is subject to change at the   *
    *                 discretion of IBM.                           *
    ****************************************************************
    *
    

Problem conclusion

  • This problem was fixed.
    

Temporary fix

Comments

APAR Information

  • APAR number

    IC97453

  • Reported component name

    TSM SERVER

  • Reported component ID

    5698ISMSV

  • Reported release

    63A

  • Status

    CLOSED PER

  • PE

    NoPE

  • HIPER

    NoHIPER

  • Special Attention

    NoSpecatt

  • Submitted date

    2013-11-06

  • Closed date

    2013-11-21

  • Last modified date

    2013-11-22

  • 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

  • R63A PSY

       UP

  • R63H PSY

       UP

  • R63L PSY

       UP

  • R63S PSY

       UP

  • R63W PSY

       UP

  • R71A PSY

       UP

  • R71H PSY

       UP

  • R71L PSY

       UP

  • R71S PSY

       UP

  • R71W PSY

       UP



Document information

More support for: Tivoli Storage Manager

Software version: 63A

Reference #: IC97453

Modified date: 22 November 2013