PI90523: NEW ORF OPTION TO INITIALIZE A DATABASE DURING ONLINE REORGANIZATION

Obtain the fix for this APAR.

APAR status

• Closed as new function.

Error description

• ORF supports a new option to initialize (empty out) a database
  during online reorganization.
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED: All users of IBM IMS Online Reorganization   *
  *                 Facility V1.1                                *
  ****************************************************************
  * PROBLEM DESCRIPTION: New keyword to initialize a database    *
  *                      during online reorganization            *
  ****************************************************************
  * RECOMMENDATION: Apply the maintenance for this APAR.         *
  ****************************************************************
  This APAR enables ORF to initialize (empty out) a database
  during online reorganization. The following APAR must be applied
  to the related product:
   APAR PI88156 for IMS HP Load V2R1 (FMID: H1IM210)
  

Problem conclusion

• ========================
  = DOCUMENTATION CHANGE =
  ========================
  The IBM IMS Database Solution Pack for z/OS Version 2 Release 2
  IMS Online Reorganization Facility User's Guide (SC27-9039-00)
  ----------------------------------------------------------------
  > Using IMS Online Reorganization Facility
  >> HRFSYSIN DD statement keywords
  The following new keyword has been added:
  INITIALIZE keyword
   Use this keyword to initialize (empty out) the database during
   the reorganization. In the Reorganization phase, IMS Online
   Reorganization Facility initializes the shadow database instead
   of reloading the data.
   The INITIALIZE keyword is optional for REORG HRFSYSIN DD
   statements and is not applicable to UNLOAD HRFSYSIN DD
   statements.
   INITIALIZE(Y) is applicable only when all of the following
   conditions are met:
   - The load library of IMS High Performance Load is included in
    the STEPLIB.
   - The primary database to reorganize is not an index.
   - If the primary database to reorganize is a HALDB with
    PSINDEXes, PSINDEXBLD(Y) is specified and the load library of
    IMS Index Builder is included in the STEPLIB.
   - DFSUINPT DD statement defines a dummy data set.
   When initialization is requested (INITIALIZE(Y)) and if online
   updates to any existing database records occur during the job,
   the job fails in the Apply phase because the shadow database is
   initialized before the Apply phase and the shadow database
   contains no database records to apply online updates to.
   Attention: Use the INITIALIZE(Y) option with caution because
   this option removes all the database records from the online
   database. The default value is N.
  ----------------------------------------------------------------
  > Troubleshooting
  >> Messages and codes
  >>> Messages
  The following new messages have been added:
  HRF01623E  INITIALIZE(Y) not available. REASON: reason
  Explanation: INITIALIZE(Y) cannot be applied because the
   conditions for applying INITIALIZE(Y) are not met.
  System action: Processing terminates.
  User response: Complete one of the following tasks depending on
   the reason indicated in the message and resubmit the job:
   HP LOAD NOT FOUND
    Ensure that the load library of IMS High Performance Load is
    specified in the STEPLIB concatenations correctly.
   INDEX NOT SUPPORTED
    Ensure that the primary database to reorganize is not an
    index database.
   PSINDEXBLD(Y) REQUIRED
    Add the PSINDEXBLD(Y) keyword to the HRFSYSIN DD statement.
  HRF01624E  DFSUINPT DD must define a dummy data set when
   INITIALIZE(Y) is specified
  Explanation:  Database initialization failed because DFSUINPT DD
   statement does not define a dummy data set.
  System action:  Processing terminates.
  User response:  To initialize (empty out) the database during
   reorganization, add the DFSUINPT DD statement that defines a
   dummy data set and rerun the job.
  ----------------------------------------------------------------
  

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:

  UI52730

Modules/Macros

• HRFOAPL1 HRFOHAL0 HRFOLEV0 HRFOREO0 HRFOREO3 HRFOREO4 HRFOREO5
  HRFOREOD HRFYCCDF HRFYMSGL HRFYMSGT HRFYPRES
  

Fix information

• Fixed component name

  IMS ONLINE REOR

• Fixed component ID

  5655H9701

Applicable component levels

• R110 PSY UI52730

     UP17/12/19 P F712

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.