PH04245: DBD SOURCE GENERATION ONLY FOR CONVERSION (RFE 28523)

Obtain the fix for this APAR.

APAR status

• Closed as new function.

Error description

• This APAR enables IMS HALDB Toolkit to analyze the DBD
  structures prior to conversion time to prevent an unexpected
  conversion failure.
  This enhancement is being implemented as a result of RFE 28523.
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED: Users of IBM IMS HALDB Toolkit V1.1.         *
  ****************************************************************
  * PROBLEM DESCRIPTION: This APAR enables IMS HALDB Toolkit to  *
  *                      analyze the DBD structures prior to     *
  *                      conversion time and prevent an          *
  *                      unexpected conversion failure.          *
  ****************************************************************
  * RECOMMENDATION: Apply the maintenance for this APAR.         *
  ****************************************************************
  This APAR enables IMS HALDB Toolkit to analyze the DBD
  structures prior to conversion time and prevent an unexpected
  conversion failure.
  1. Batch ANALYZEPART function
  The new options, DBDSOURCE, DSG1, OSAM and DBDSRCONLY
  parameters have been added.
  2. ISPF function 5 Convert entire DBD library to HALDB
  - The new option 5 DBD source generation only has been added.
  In addition, the following problem has been fixed in this APAR:
  - When running ISPF function 5(Convert entire DBD library to
    HALDB), and single DSG is selected for Multi DSG in DBD
    Conversion Rules, DSG1(Y) is not generated correctly.
  ========================
  = 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 2 Release 1
  IMS High Availability Large Database Toolkit User's Guide
  (SC27-8779-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 2. Simulating HALDB using ANALYZEPART
  ANALYZEPART DD statements
   SYSPRINT DD has been added as follows:
   Table 3. DD statements and record format for the ANALYZEPART
   command
  
    DD Name     Use      Format         Need
    ----------------------------------------------------------
  | SYSPRINT    Output   LRECL=133      Optional
  
  | SYSPRINT
  |   This statement is optional. This statement defines the
  |   statistics output data set and output from other utilities
  |   that are executed under the control of IMS HALDB Toolkit.
  |   The data set can reside on DASD, or it can be routed through
  |   the output job. IMS HALDB Toolkit dynamically allocates this
  |   data set if you do not provide it.
  
  
  ANALYZEPART command parameters
   DBDSOURCE, DSG1, OSAM and DBDSRCONLY parameters have been
   added to the following new table:
   Table. ANALYZEPART command parameters for generating
          DBD source
  
    Parameter   Requirement   Description
    --------------------------------------------------------------
  | DBDSOURCE   Required      Generates the DBD source for the
  |                           converted HALDB and places it in the
  |                           specified library.
  |                           You must also specify the dbdsource
  |                           DD statement in the JCL.
  |                           The data set that you specify for
  |                           dbdsource DD must be a partitioned
  |                           data set (PDS) or a partitioned data
  |                           set extended (PDSE) with LRECL=80
  |                           and RECFM=F. SYSOUT=* cannot be
  |                           specified for this data set.
  |                           Format: (ddname)
  |                           Default value: None.
  | DBDSRCONLY  Optional      Generates the DBD source without
  |                           simulating HALDB conversion. No
  |                           reports are generated in the IHCLIST
  |                           data set.
  |                           Format: (Y | N)
  |                           Default value: N
  | DSG1        Optional      Changes a database with multiple
  |                           data set groups into a database with
  |                           a single data set group.
  |                           Format: (Y | N)
  |                           Default value: N
  | OSAM        Optional      Converts VSAM to OSAM.
  |                           Format: (Y | N)
  |                           Default value: N
  
  For more information about generating DBD source,
  see User Guide updates.
  

Problem conclusion

Temporary fix

Comments

• This APAR enables IMS HALDB Toolkit to analyze the DBD
  structures prior to conversion time and prevent an unexpected
  conversion failure.
  1. Batch ANALYZEPART function
  The new options, DBDSOURCE, DSG1, OSAM and DBDSRCONLY
  parameters have been added.
  2. ISPF function 5 Convert entire DBD library to HALDB
  - The new option 5 DBD source generation only has been added.
  In addition, the following problem has been fixed in this APAR:
  - When running ISPF function 5(Convert entire DBD library to
    HALDB), and single DSG is selected for Multi DSG in DBD
    Conversion Rules, DSG1(Y) is not generated correctly.
  

APAR Information

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

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

  UI61410

Modules/Macros

• IHCM10   IHCPAN51 IHCSDBD0 IHCSDBD6 IHCSDBDL IHCUDFSH IHCULEV0
  IHCUTIC0 IHCWANA3 IHCWCONV IHCWDBD6 IHCWDBD7 IHCWDBD8 IHCWDBD9
  IHCWDBL0 IHCWDBLB IHCWDBRC IHCWDSN0 IHCWDSN1 IHCWENV0 IHCWISP0
  IHCWISP1 IHCWISP2 IHCWISP3 IHCWISP4 IHCWISP5 IHCWISP6 IHCWISPF
  IHCWJCLG IHCWKEYS IHCWLIU0 IHCWPART IHCWPROJ IHCWRUPD IHCWSEL1
  IHCWSETU IHCWTDB0 IHCWTDB1 IHCWTDB2 IHCWTDB3 IHCWTDB4 IHCWTDB7
  IHCWTDB8 IHCWTDBA IHCWTDBB IHCWTDBG IHCWTDRC IHCWTKOV IHCWTRCK
  IHCWUNL0 IHCWUNLF IHCWUOW7 IHCWUTI0 IHCWUTIL IHCWWTIF IHCYCCDF
  IHCYCMD0 IHCYINST IHCYMSGT IHCYRC12 IHCYRC13 IHCYRC14 IHCYRC15
  

Fix information

• Fixed component name

  IMS HA DB TOOLK

• Fixed component ID

  5655DBU01

Applicable component levels

• R110 PSY UI61410

     UP19/02/22 P F902  

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.