PI92219: FORWARD-FIT OF DBSP V2.1 IMS HALDB TOOLKIT APARS PI85067, PI87941 AND PI90471

Obtain the fix for this APAR.

APAR status

• Closed as new function.

Error description

• Forward-fit of DBSP V2.1 IMS HALDB Toolkit NF APARs PI85067,
  PI87941 and PI90471.
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED: Users of IBM IMS HALDB Toolkit V1.1.         *
  ****************************************************************
  * PROBLEM DESCRIPTION: Forward-fit of DBSP V2.1 IMS HALDB      *
  *                      Toolkit NF APARs PI85067, PI87941 and   *
  *                      PI90471.                                *
  ****************************************************************
  * RECOMMENDATION: Apply the maintenance for this APAR.         *
  ****************************************************************
  1. Forward-fit of PI85067
  This APAR provides a new option of ICTRLR parameter for
  MAINTAIN/CONVERT function to support yyddd format in the image
  copy dsn.
  In addition, the following problem have been fixed in this APAR:
  - When ICTRLR parameter is not specified, image copy data sets
    are created with Dddmmyy.Thhmmss format(ICTRLR(4)) instead of
    Dyymmdd.Thhmmss format(ICTRLR(2); default value).
  2. Forward-fit of PI87941
  This APAR provides a new option of INPUT parameter for
  ANALYZEPART function to support unload data sets as input for
  simulation.
  In addition, the following problem has been fixed in this APAR:
  - Regarding CONVERT function, SHISAM cannot be converted. This
    is the database limitation. However CONVERT function does not
    issue any error messages when specified DBD is SHISAM.
  3. Forward-fit of PI90471
  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

• Code has been changed and added to provide new options
  described in this APAR.
  
  ========================
  = 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 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 2. Simulating HALDB using ANALYZEPART
  ANALYZEPART DD statements
   DFSUINPT DD has been added as follows:
   Table 3. DD statements and record format for the ANALYZEPART
   command
  
    DD Name     Use      Format         Need
    ----------------------------------------------------------
  | DFSUINPT    Input    Same as IMS    Conditionally required
  
  | DFSUINPT
  |   This statement is required when you supply unloaded data
  |   sets as input. The statement specifies one or more data sets
  |   that contain unloaded data of a full-function database or of
  |   a HALDB.
  |   The supported format of the unloaded data sets is HD unload
  |   format. The ANALYZEPART function processes all the data sets
  |   that are specified on this DD statement and all the data
  |   inside the data sets.
  |   For more information about supplying unloaded data sets as
  |   input, see the following topics:
  |   "Simulating conversion or repartitioning using unloaded data
  |   sets as input"
  |   "ANALYZEPART example: Using unloaded data sets as input"
  
  ANALYZEPART command parameters
   INPUT parameter has been added to the following table:
   Table 4. ANALYZEPART command parameters
  
    Parameter   Requirement   Description
    --------------------------------------------------------------
  | INPUT       Optional      Specifies that the input is unloaded
  |                           data sets.
  |                           Code the DFSUINPT DD to specify the
  |                           unloaded data sets.
  |                           Format: (UNLOAD)
  |                           Default value: None
  
  For more information about supplying unloaded data sets as
  input, see the following topics:
  "Simulating conversion or repartitioning using unloaded data
  sets as input"
  "ANALYZEPART example: Using unloaded data sets as input"
  
  Chapter 3. Converting to HALDB using CONVERT
  CONVERT command parameters
  
  Description of parameter ICTRLR has been modified as follows:
  
    Specifies whether to use another final suffix qualifier for
    image copy data sets.
  
  | Format: (1 - 6)
    The ICTRLR parameter specifications render the following final
    suffix qualifiers:
    ICTRLR(1)
                 GDG
    ICTRLR(2)
                 Dyymmdd.Thhmmss
    ICTRLR(3)
                 Dmmddyy.Thhmmss
    ICTRLR(4)
                 Dddmmyy.Thhmmss
    ICTRLR(5)
                 None.
  | ICTRLR(6)
  |              Dyyddd.Thhmmss
  
    Default value: 2
  
  Chapter 4. Maintaining HALDB using MAINTAIN
  MAINTAIN command parameters
  
  Description of parameter ICTRLR has been modified as follows:
  
    Specifies whether to use another final suffix qualifier for
    image copy data sets.
  
  | Format: (1 - 6)
    The ICTRLR parameter specifications render the following final
    suffix qualifiers:
    ICTRLR(1)
                 GDG
    ICTRLR(2)
                 Dyymmdd.Thhmmss
    ICTRLR(3)
                 Dmmddyy.Thhmmss
    ICTRLR(4)
                 Dddmmyy.Thhmmss
    ICTRLR(5)
                 None.
  | ICTRLR(6)
  |              Dyyddd.Thhmmss
  
    Default value: 2
  
  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:

  UI53498

Modules/Macros

•    IHCSRELD IHCSRELH IHCSRELU IHCSRELX IHCULEV0
  IHCUTIC0 IHCWANA3 IHCWANA4 IHCWAN12 IHCWAN13 IHCWAN14 IHCWAN15
  IHCWJCLG IHCWLIU0 IHCWPART IHCWPROJ IHCWREIM IHCWREL0 IHCWRUPD
  IHCWTDBA IHCWTDBB IHCWTDBG IHCWTDB0 IHCWTDB1 IHCWTDB2 IHCWTDB3
  IHCWTDB4 IHCWTDB7 IHCWTDB8 IHCWTDRC IHCWTKOV IHCWUNL0 IHCYCCDF
  IHCYMSGT
  

Fix information

• Fixed component name

  IMS HA DB TOOLK

• Fixed component ID

  5655DBU01

Applicable component levels

• R110 PSY UI53498

     UP18/01/30 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.