PI90471: ENABLE IMS HALDB TOOLKIT TO USE DFSURGL0 FOR LOADING PSINDEX WHEN USING COMBINED LOAD LIBRARY IN STEPLIB WITH HP LOAD MODULES

Obtain the fix for this APAR.

APAR status

• Closed as new function.

Error description

• This APAR enables IMS HALDB Toolkit to use the HD Reorganization
  Reload utility (DFSURGL0) to load PSINDEX databases even when
  IMS High Performance Load modules exist in a combined load
  library of IMS Database Solution Pack in STEPLIB.
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED: Users of IBM IMS Database Solution Pack V2.1 *
  *                 IMS HALDB Toolkit.                           *
  ****************************************************************
  * PROBLEM DESCRIPTION: This APAR enables IMS HALDB Toolkit to  *
  *                      use DFSURGL0 for loading PSINDEX when   *
  *                      using combined load library in STEPLIB  *
  *                      with HP Load modules.                   *
  *                      This enhancement is being implemented   *
  *                      as a result of the RFE 97930.           *
  ****************************************************************
  * RECOMMENDATION: Apply the maintenance for this APAR.         *
  ****************************************************************
  This APAR enables IMS HALDB Toolkit batch and ISPF MAINTAIN to
  use DFSURGL0 for loading PSINDEX when using combined load
  library in STEPLIB with HP Load modules.
  In addition, the following problems have been fixed in this
  APAR:
  - When DFSURGL0 (HD Reorganization Reload utility) is used for
    loading databases under batch MAINTAIN, value for loaded DB
    records in IHC01000I is incorrect.
  - When PSINDEX is maintaied under ISPF environment and
    Partitioning evaluation separate is selected on Project
    Definition Settings, a generated JCL for HD Reorganization
    Reload utility is incorrect, and JCL error can be occurred.
  - When using combined load library as HTK's loadlib, steplib in
    a generated JCL for HD Reorganization Reload utility includes
    the combined load library. However, the combined load library
    should not be included.
  

Problem conclusion

Temporary fix

Comments

• When PSINDEX is maintained under batch environment, DFSURGL0 in
  DFSRESLB DD is used for loading database.
  When PSINDEX is maintaied under ISPF environment,
  - When Partitioning evaluation during UNLOAD is selected on
    Project Definition Settings, method is automatically changed
    to Partitioning evaluation separate to use IMS DFSURGU0 and
    DFSURGL0.
  - When High Performance Unload is selected on Utility Setup for
    UNLOAD, utility is automatically changed to Standard IMS
    (DFSURGU0).
  - When High Performance Reload is selected on Utility Setup for
    RELOAD, utility is automatically changed to Standard IMS
    (DFSURGL0).
  So when using combined load library in STEPLIB with HP Load
  modules, MAINTAIN PSINDEX ends normally without any JCL changes.
  
  ========================
  = DOCUMENTATION CHANGE =
  ========================
  IBM IMS Database Solution Pack for z/OS Version 2 Release 1
  IMS High Availability Large Database Toolkit for z/OS User's
  Guide (SC19-4102-02)
  ----------------------------------------------------------------
  Chapter 1. IMS HALDB Toolkit overview
  Usage and restrictions
   The database limitations section has been modified as follows:
   Database limitations
     :
  | The MAINTAIN function processes PSINDEXes only when the
  | PSINDEX is offline.
  
  Chapter 4. Maintaining HALDB using MAINTAIN
  MAINTAIN DD statements
   Explanation for DFSRESLB DD has been modified as follows:
   DFSRESLB
      This statement is optional. The statement points to an
      authorized library that contains IMS SVC modules.
      IMS HALDB Toolkit dynamically allocates this DD if you
      do not provide it.
  |   Even if IMS High Performance Load modules are found in the
  |   combined load library of IMS Database Solution Pack in the
  |   STEPLIB concatenation, when the MAINTAIN function processes
  |   PSINDEXes, the function uses DFSURGL0 (HD Reorganization
  |   Reload utility) in this library to reload PSINDEXes.
  
  Chapter 29. Messages and codes
  Batch messages
   The following new message has been added:
  | IHC01205E DFSRESLB DD is required to MAINTAIN PSINDEX.
  |
  | Explanation:  When the MAINTAIN function processes PSINDEXes,
  | the function uses DFSURGL0 (HD Reorganization Reload utility)
  | in the DFSRESLB DD to reload databases. Because the DFSRESLB
  | DD statement is not coded in the JCL, IMS HALDB Toolkit
  | attempted to dynamically allocate the DFSRESLB DD statement
  | using the IMS RESLIB library. However, the IMS RESLIB library
  | containing IMS SVC modules was not found in the STEPLIB
  | concatenation so IMS HALDB Toolkit did not allocate the
  | DFSRESLB DD statement.
  |
  | System action: Processing terminates.
  |
  | User response: Specify the IMS RESLIB library containing IMS
  | SVC modules to the STEPLIB DD statement or the DFSRESLB DD
  | statement and rerun the job.
  

APAR Information

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

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

  UI53066

Modules/Macros

• IHCSRELD IHCSRELH IHCSRELU IHCSRELX IHCULEV0
  IHCWJCLG IHCWPART IHCWPROJ IHCWREIM IHCWREL0 IHCWUNL0 IHCYMSGT
  

Fix information

• Fixed component name

  IM DB SOLUTION

• Fixed component ID

  5655S7700

Applicable component levels

• R210 PSY UI53066

     UP18/01/11 P F801

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.