PM94789: ENABLE THE SMART REORG UTILITY TO BUILD PSINDEXES WHILE A HALDB IS BEING REORGANIZED.

Obtain the fix for this APAR.

APAR status

• Closed as new function.

Error description

• Enable the Smart Reorg utility to build PSINDEXes while a HALDB
  is being reorganized.
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED: All users of IBM IMS High Performance Load   *
  *                 for z/OS Version 2 Release 1 (FMID=H1IM210). *
  ****************************************************************
  * PROBLEM DESCRIPTION: This APAR enables the Smart Reorg       *
  *                      utility of IMS Database Reorganization  *
  *                      Expert for z/OS to build every PSINDEX  *
  *                      by invoking IMS Index Builder           *
  *                      while a HALDB is being reorganized.     *
  ****************************************************************
  * RECOMMENDATION: Apply the maintenance for this APAR.         *
  ****************************************************************
  This APAR enables the Smart Reorg utility of IMS Database
  Reorganization Expert for z/OS to build every PSINDEX by
  invoking IMS Index Builder while a HALDB is being reorganized.
  
  To use the new function, see the description of APAR PM94787
  for IMS Database Reorganization Expert for z/OS,
  Version 4 Release 1 (FMID=H25N410).
  

Problem conclusion

Temporary fix

Comments

• ========================
  = Documentation Change =
  ========================
  IMS High Performance Load for z/OS Version 2 Release 1 User's
  Guide SC18-9222-05 ( SC18922205 ) should be changed as follows:
  ================================================================
  
  2.1.4 JCL requirements
  
     :
    HPSRPnnn DD
  
      Describes the WFP work data sets. WFP data sets are work
      data sets that can be used by Index Builder to rebuild
      partition secondary indexes (PSINDEXes). These data sets are
      created while IMS HP Load reloads HALDB partitions.
      One work data set is created for each HALDB partition.
  |   If you want IMS HP Load to dynamically allocate WFP data
  |   sets, omit this DD statement.
  
      For nnn, specify a 3-digit decimal number from 001 to 999.
      The value can also be T00 or T01. T01 represents 1000, and
      T01 represents 1001. If you designate IMS HP Load to
      dynamically allocate the WFP data sets, IMS HP Load uses
      sequence numbers for nnn.
  
      The data sets must reside on a direct-access device.
  
      Create WFP data sets when all of the following conditions
      are met:
  |   - The database has PSINDEXes.
  |   - You are going to rebuild the PSINDEXes by using IMS Index
  |     Builder in a subsequent job step or in another job.
      - You want to avoid scanning the database while rebuilding
        indexes with IMS Index Builder.
  
      If you are not sure whether the HALDB database contains
      empty partitions, use the unloaded data set that is created
      by IMS HP Unload with the CHECKREC=YES option. Otherwise,
      WFP data sets are not created for the empty partitions.
  
      Naming convention for WFP data sets
  DELETE:
  |     If you want IMS HP Load to dynamically allocate WFP data
  |     sets, omit this DD statement.
  DELETE:
        If you specify the names of WFP data sets by using
        HPSRPnnn DD statements, ensure that the data set names on
        the DSN parameters conform to the following naming
        convention.
        :
  
  2.1.5.16 ILDSBLD control statement
  
    Specifies whether to build ILDS and how to build the ILDS.
    This control statement is optional. If you do not explicitly
    specify this control statement, ILDSBLD=YES,DSPR will be used.
  
    Note: ILDSBLD=YES is obsolete. If you specify ILDSBLD=YES,
          ILDSBLD=YES,DSPR is used.
  
      ___________________________________________________________
     |                                                           |
     |                _YES___,DSPR_______                        |
  |  |               |    |__,INITONLY_| |                       |
     | >>__ILDSBLD=__|_C_________________|____________________>< |
     |               |_NO________________|                       |
     |                                                           |
     |___________________________________________________________|
  
    YES,DSPR
      ILDS is rebuilt with using less amount of data space than
      the obsolete option ILDSBLD=YES.
      In the process of rebuilding, the records of ILDS are
      arranged in sequence of the key value by using DFSORT.
      If you do not specify DD statements for HPSRILEA, HPSRILEB,
      and HPSRWKnn work data sets, which are used as SORTIN and
      SORTWK data sets, these data sets are allocated dynamically.
  
      You can specify the data class and the storage class for
      HPSRILEA and HPSRILEB data sets by using ILEDATAC and
      ILESTORC control statements.
  
  | YES,INITONLY
  |   ILDS is just initialized and no ILEs are built. If the HALDB
  |   has no logical relationships and you are going to rebuild
  |   the PSINDEXes by using IMS Index Builder in a subsequent job
  |   step or in another job, this statement can be used.
  
    C
      ILDS is rebuilt in the same manner of IMS HD Reorganization
      Reload.
    :
  
  6.1.3 HPSROPT macro statements
  
    :
  RELOAD:
             <_,__________________________________________
   |__RELOAD___ __________________________________________ |____|
               |_ _________________________________ ______|
               | |             _(YES,WARN_______)__|      |
               | |            |       _,WARN__     |      |
               | |_CHKTRAIL=__|_(YES_|_,ERROR_|_)__|      |
               |              |_NO_________________|      |
               |_ ______________________________________ _|
                    :
               |_ ________________ _______________________|
               | |_HPIO=__ _NO__ _|                       |
               |          |_YES_|                         |
               |_ __________________________ _____________|
               | |            _(YES_,___DSPR_______)_     |
  |            | |           |        |_INITONLY_|   |    |
               | |_ILDSBLD=__|_C_____________________|____|
               |             |_NO____________________|    |
               |_ ________________________ _______________|
                    :
  

APAR Information

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

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

  UK97344

Modules/Macros

• HPSRCILA HPSRCILB HPSRCIL2 HPSRCIL3 HPSRCIL7 HPSRCIL8 HPSRCIL9
  HPSRFCA0 HPSRGTI0 HPSRGVT0 HPSRHDBA HPSRHDBB HPSRHDB2 HPSRHDB3
  HPSRHDB7 HPSRHDB8 HPSRHDB9 HPSRHRPA HPSRHRPB HPSRHRP2 HPSRHRP3
  HPSRHRP7 HPSRHRP8 HPSRHRP9 HPSROPT  HPSROPTA HPSROPTS HPSRRLDA
  HPSRRLDB HPSRRLD2 HPSRRLD3 HPSRRLD7 HPSRRLD8 HPSRRLD9 HPSRRRI0
  HPSRRRI9 HPSRSTMT HPSRWFP0 HPSRWFP3
  

Fix information

• Fixed component name

  IMS HIGH PERF L

• Fixed component ID

  5655E0700

Applicable component levels

• R210 PSY UK97344

     UP13/09/07 P F309

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.