PM18995: DB REPAIR FACILITY ENHANCEMENT FOR OSAM 4GB - 8GB SUPPORT

Obtain the fix for this APAR.

APAR status

• Closed as new function.

Error description

• DB Repair Facility enhancement for improving the OSAM 4GB-8GB
  data process.
  This APAR addresses a market requirement MR0514106126.
  

Local fix

• N/A
  

Problem summary

• ****************************************************************
  * USERS AFFECTED: IBM IMS Database Repair Facility (DBRF) for  *
  *                 z/OS Version 3 Release 1 (FMID=H22K310)      *
  *                 users who repair an OSAM database data set.  *
  ****************************************************************
  * PROBLEM DESCRIPTION: This APAR enables DBRF to repair a      *
  *                      block beyond 4 giga byte (GB) for an    *
  *                      OSAM database data set.                 *
  ****************************************************************
  * RECOMMENDATION: Apply the maintenance for this APAR.         *
  ****************************************************************
  This APAR provides the following functions to repair an OSAM
  database data set.
  
  1) Using the Repair Facility interactively
  
    Before this APAR, DBRF was able to repair a block beyond 4 GB
    when either "RBA" or "Root key" is specified on the Initial
    selection panel. By this APAR, "BLK #" is also able to
    specified on the Initial selection panel.
  
  2) Using the Repair Facility in batch mode for OSAM
  
    Before this APAR, DBRF was not able to repair a block beyond
    4 GB. By this APAR, DBRF is able to repair it.
  
  3) Nine digits hexadicimal number can be used for RBA as an
     input in DB Repair Facility interactive mode and batch mode.
  
    Before this APAR, eight digits hexadecimal number was maximum
    allowed as an input RBA value.
    This APAR enhances the allowable digits from eight to nine.
  

Problem conclusion

Temporary fix

Comments

• Documentation Changes:
  Note: The section numbers are those of the BookManager (BKMGR)
  book.
  The documentation is modified as follows:
  ==============================================================
    IMS High Performance Pointer Checker for z/OS, V3R1,
    User's Guide (SC19240100)
  
    Some of the following descriptions were updated once
    by "Update 6: May 2010" in IMS Tools Product publications
    web site (http://www-01.ibm.com/software/data/db2imstools/
    imstools-library.html). They are changed again by this APAR.
  ==============================================================
  >>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>
  APPENDIX1         Appendixes
  APPENDIX1.1       Appendix A. Database Repair Facility
  >>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>
  --------------------------------------------------------------
  APPENDIX1.1.1     Overview of the Repair Facility
  APPENDIX1.1.1.7   Restriction of the Repair Facility
  --------------------------------------------------------------
  The following descriptions are deleted :
  
    Restrictions for OSAM data sets that are lager than 4 GB
      When the Repair Facility is used interactively, it can
      process data that is located between 4 GB and 8 GB. However,
      you cannot specify data that is beyond 4 GB by using the
      BLK# option. To specify data beyond 4 GB, use the RBA or the
      Root Key option. For more information for specifying the RBA
      that is beyond 4 GB, see "Appendix 1.1.2.7.5.2 Initial
      selection panel for HDAM, HIDAM, and DEDB databases".
  
      When the Repair Facility is used in batch mode, it does not
      support data that is located between 4 GB and 8 GB.
  --------------------------------------------------------------
  APPENDIX1.1.2     Using the Repair Facility interactively
  APPENDIX1.1.2.7   View/update database
  APPENDIX1.1.2.7.5 Processing HD or DEDB database
  --------------------------------------------------------------
  The following descriptions for RBA are modified:
  
    RBA
      You can specify the relative byte address with which to
      access a database segment. You can access any segment
      provided the RBA points to a valid segment code.
  
      To display an individual segment, the RBA must point to a
      valid segment code. For any other RBA, the Repair Facility
      displays the block containing that RBA.
  
  |   When the database is HDAM or HIDAM and the database data set
  |   is an OSAM with an even block size, the maximum database
  |   size can be 8 GB.
  |
  |   The RBA beyond 4 GB for the OSAM database data set can be
  |   specified in hexadecimal by the following expressions.:
  |    - Nine digit value (the maximum value is X'1FFFFFFFF')
  |    - Eight digit value, the RBA value by incrementing the last
  |      bit by 1. In this way, the Database Repair Facility
  |      assumes the value is over 4 GB for the even-block size
  |      OSAM. (the maximum value is X'FFFFFFFF')
  |   For example, to specify 4294968320, you can use the
  |   following nine or eight digits:
  |    - Nine digits: 100000400
  |    - Eight digits: 00000401
  |
  |   Note: Nine digit RBA is used only at the time you enter the
  |   value. Even if you enter a nine digit value, the RBA value
  |   is displayed in eight digits on the panels and messages.
  --------------------------------------------------------------
  APPENDIX1.1.4     Using the Repair Facility in batch mode for
                    OSAM
  APPENDIX1.1.4.3   SYSIN data set
  APPENDIX1.1.4.3.3 ORBA control statement
  --------------------------------------------------------------
  The following descriptions for record-rba are modified:
  
    record-rba
      The relative byte address of the OSAM record. It can be
      specified as either of the following expressions:
  
  |   - A decimal expression (for example, 4096). The allowable
  |     maximum value is 8589934591.
  |   - A hexadecimal expression (for example, X'1000'). The
  |     allowable maximum value is X'1FFFFFFFF'.
  
  |   When the database is HDAM or HIDAM and the database data set
  |   is an OSAM with an even block size, the maximum database
  |   size can be 8 GB.
  |   The RBA beyond 4 GB for the OSAM database data set can be
  |   specified in hexadecimal by the following expressions:
  |    - Nine digit value (the maximum value is X'1FFFFFFFF')
  |    - Eight digit value, the RBA value by incrementing the last
  |      bit by 1. In this way, the Database Repair Facility
  |      assumes the value is over 4 GB for the even-block size
  |      OSAM. (the maximum value is X'FFFFFFFF')
  |
  |   For example, to specify 4294968320 by hexadicimal,
  |   you can use the following nine or eight digits:
  |    - Nine digits: 100000400
  |    - Eight digits: 00000401
  |
  |   Note: Nine digit RBA is used only at the time you enter the
  |   value. Even if you enter a nine digit value, the RBA value
  |   is displayed in eight digits on the reports and messages.
  
  The following description is deleted:
  
     Note: This control statement does not support data that is
     located over 4GB. Use the Repair Facility interactively to
     process the data of an OSAM data set that is located between
     4 GB and 8 GB.
  --------------------------------------------------------------
  APPENDIX1.1.4     Using the Repair Facility in batch mode for
                    OSAM
  APPENDIX1.1.4.3   SYSIN data set
  APPENDIX1.1.4.3.4 OBLK control statement
  --------------------------------------------------------------
  The following description is deleted :
  
      - A hexadecimal expression that consists of an even number
        of digits (for example, X'1000'). A leading zero must be
        added to an odd number of digits (for example, X'010B00').
        The allowable maximum value is X'FFFFFFFF'.
  

APAR Information

• APAR is sysrouted FROM one or more of the following:

• APAR is sysrouted TO one or more of the following:

  UK59970

Modules/Macros

• FABZMAIN FABZOSMB FABZPS1  FABZPS1P
  

Fix information

• Fixed component name

  IMS DATABASE RE

• Fixed component ID

  5655E0300

Applicable component levels

• R310 PSY UK59970

     UP10/08/28 P F008

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.