PI88980: CHANGE THE THRESHOLD OF EXTENT PARAMETER FROM 0-123 TO 0-251

Obtain the fix for this APAR.

APAR status

• Closed as program error.

Error description

• Change the threshold of EXTENT parameter for CHECK command from
  0-123 to 0-251.
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED: Users of IBM IMS HALDB Toolkit V1.1.         *
  ****************************************************************
  * PROBLEM DESCRIPTION: Change the threshold of EXTENT          *
  *                      parameter for CHECK command from 0-123  *
  *                      to 0-251.                               *
  ****************************************************************
  * RECOMMENDATION: Apply the maintenance for this APAR.         *
  ****************************************************************
  The maximum number of extents per data set is 251 for VSAM,
  but the threshold of EXTENT parameter for CHECK command is from
  0-123.
  So when the number of extents per data set is greater than 123,
  you cannnot get a warning or a critical warning correctly.
  

Problem conclusion

• The threshold of EXTENT parameter for CHECK command has been
  changed from 0-123 to 0-251.
  
  ========================
  = DOCUMENTATION CHANGE =
  ========================
  IBM IMS Database Solution Pack for z/OS Version 2 Release 2
  IMS High Availability Large Database Toolkit User's Guide
  (SC27-9038-00) and
  IBM IMS Database Utility Solution for z/OS Version 1 Release 1
  IMS High Availability Large Database Toolkit User's Guide
  (SC27-9007-01)
  ----------------------------------------------------------------
  Chapter 6. Using the HALDB Analyzer
  CHECK command parameters
  
  Description of parameter EXTENT has been modified as follows:
  
    Indicates the extent number that triggers a warning.
  
    The maximum number of extents allowed depends on the data
    management type.
  |   VSAM: The maximum number of extents per data set is 251.
  |         The maximum number of extents per volume is 123.
  |   OSAM: The maximum number of extents per data set depends on
  |         the version of IMS; approximately 60 for IMS V13,
  |         and approximately 120 for IMS V14 and later.
  |         The maximum number of extents per volume is 16.
  
    When no more extents are possible, an attempt to obtain a new
    one creates an out-of-space condition, which leads to an 844
    IMS abend.
    The purpose of the EXTENT parameter settings is to prevent
    this occurrence.
  
    Format: (lll,hhh)
    lll   Sets the low threshold. Specify a number in the range of
  |       0 - 251. You will get a warning when this value is
          exceeded. If you specify a value of 0, this warning is
          suppressed.
    hhh   Sets the high threshold. Specify a number in the range
  |       of 0 - 251. You will get a critical warning when this
          value is exceeded. If you specify a value of 0, this
          warning is suppressed.
  
    Default value: None.
      :
      :
  

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:

  UI51555

Modules/Macros

•    IHCULEV0 IHCYCCDF
  

Fix information

• Fixed component name

  IMS HA DB TOOLK

• Fixed component ID

  5655DBU01

Applicable component levels

• R110 PSY UI51555

     UP17/11/02 P F711

Fix is available

• Select the PTF appropriate for your component level. You will be required to sign in. Distribution on physical media is not available in all countries.