Converting to HALDB using the ISPF user interface

You can use the ISPF user interface to convert your full-function databases to HALDB.

Procedure

  1. When the IMS management of ACBs is enabled, create the IMS catalog staging data sets. You can refer to the examples in CONVERT example: Preparing a staging data set before converting a database when the IMS management of ACBs is enabled.
  2. To display the DBD Conversion Selection panel, select option 1 (Continue with Current Project) from the Project Work panel.
    If you did not select DBDs, or if you cleared the project data set, this step is necessary.
  3. Select one of the provided DBD libraries, or enter a specific DBD library and press Enter to see a list of DBDs.

    When the IMS management of ACBs is enabled, no DBD library is displayed. Press Enter without selecting or specifying a DBD library.

    All DBDs and related databases must be converted together. You must select, at minimum, the primary DBD.

    All related DBDs and indexes will be automatically included. In addition, you can add DBDs that are not related (from an IMS perspective), and they will be converted at the same time.

    Figure 1. DBD Conversion Selection panel
    ------------------------------ IMS HALDB Toolkit -----------------------------
    Command ===>                                                                  
                                                                                  
               DBD Conversion selection                                           
                                                                                  
               Select one of the provided DBD libraries                           
               or specify a DBD library below                                     
               1      your.DBDLIB                                      
               2                                                                  
               3                                                                  
               4                                                                  
               5                                                                  
               6                                                                  
               7                                                                  
               8                                                                  
               9                                                                  
                                                                                  
               Specify a DBDLIB dataset name:                                     
               your.DBDLIB                                             
                                                                                  
               DBD    *                "*" for list of DBDs                      
    
    Figure 2. DBD Conversion Selection panel when the IMS management of ACBs is enabled
    ------------------------------ IMS HALDB Toolkit -----------------------------
    Command ===>                                                                  
                                                                                  
               DBD Conversion selection                                           
                                                                                  
               Select one of the provided DBD libraries                           
               or specify a DBD library below                                     
               1                                                                  
               2                                                                  
               3                                                                  
               4                                                                  
               5                                                                  
               6                                                                  
               7                                                                  
               8                                                                  
               9                                                                  
                                                                                  
               Specify a DBDLIB dataset name:                                     
                                                                                  
                                                                                  
               DBD    *                "*" for list of DBDs                       
    

  4. Select the primary DBD to be converted; related DBDs are automatically added to the list.
    Figure 3. Selection panel for DBDs to be converted
    ------------------------------ IMS HALDB Toolkit ------------------Row 1 of 115
    Command ===>                                              Scroll ===> PAGE
    
                                               Select all DBDs you want
              Select   DBD                     but only one selection at a time
    ---------------------------------------------------------------------------
                       DEDB1
                       HD01
              s        HD02
                       HD02TT
                       HDV1
                       HDV2
                       HDX2
                       HIDAM2
                       HID02
                       HID03
                       HID04
                       HIDV2
                       HISAM
                       HISAM1
                       HPI20
                       HPI30
                       HPI40
                       HPV20
                       JDO2
                       JIO21
                       JIO22
                       JIO23
                       JIO24
                       KEY120
                       LDBD1
     

  5. Press the End key to display the status panel showing all selected DBDs.
  6. View your selections, and press the End key to display the following DBD Selection for Project xxxxx panel, which allows you to confirm that the DBD list is complete.
    Figure 4. Confirmation panel for DBD selections
    ------------------------------ IMS HALDB Toolkit -----------------------------
    Command ===>
    
    
                   DBD Selection for Project 0-HDO2
    
    
           Confirm the end of DBD Selection
    
           Y      "Y" If no more DBDs are to be added
                  "N" If more DBDs are to be added
                  "H" Hold project
    

  7. Continue processing the project as described in Processing a project.
  8. When the IMS management of ACBs is enabled, issue the IMPORT DEFN SOURCE(CATALOG) command to activate the new database definition.
  9. When the IMS management of ACBs is enabled, take an image copy manually.
  10. After the conversion process is complete and you are certain that you will not need to revert the database to its non-HALDB state, you can delete any DFSMDA members for the old database.