Loading into an uninitialized database

You can use the Initial option to load data into an uninitialized database. This option only supports Dynamic PSBs and DLI region types. The database must have already been emptied using the Delete/Define data sets utility or you must select the Delete/define data sets option during this process.

To load data into an uninitialized IMS database:

  1. Select option 3 Utilities from the Primary Option Menu and then option 4 Load from the Utility Menu. The Load Entry Panel is displayed.
  2. In the Subsystem name field, enter the ID of the IMS subsystem that the database you want to access is defined in, or if you want to select the required subsystem from a list, enter a subsystem name pattern or leave the field blank.
  3. In the Database name field, enter the name of the database that you want to access, or if you want to select a database from a list of DBDs, enter a database name pattern or leave the field blank.
  4. In the PSB type field, enter 1 to select a dynamic PSB.
  5. In the Region type field, enter 1 to select a DL/I batch processing region.
  6. If you selected a database that is not a HALDB and an IMS subsystem that is not a dynamic allocation only subsystem, in the Fetch DB dsnames from field:
    • Enter 1 if you want the function to use the database data sets whose names were saved in your user profile.
    • Enter 2 if you want the function to use the database data sets specified in the DFSMDA dynamic allocation members.
  7. In the Load type field, enter 3to select a Load that uses a load PSB (PROCOPT=L).
  8. If you want to skip the display of the Database Data Set Specification or the Database Data Set Display panel, enter "/" in the Skip DB data set panel field.
  9. Press Enter to process the data you entered. According to what you entered on the panel, one or more of these panels may be displayed in the order they are listed:
    • Subsystem Selection panel
      • Displayed when you enter no subsystem name or a subsystem name pattern.
      • Displays a list of IMS subsystems defined by the FM/IMS administrator at installation time.
    • Database Selection panel
      • Displayed when you enter no database name or a database name pattern.
      • Displays a list of the DBDs in the DBD libraries for the specified subsystem.
      If the DBD libraries for the subsystem are not fixed, you specify the DBD libraries for the subsystem on the PSB and DBD Data Sets panel (option 0.6.7). If the DBD libraries for the subsystem are fixed, the FM/IMS administrator specifies the DBD libraries for the subsystem at installation time.

    On each selection panel that is displayed, enter S in the Cmd field adjacent to the item you want to select and press Enter.

  10. If you did not select the Skip DB data set panel option, either the Database Data Set Display or the Database Data Set Specification panel is displayed.
    • The Database Data Set Display panel is displayed when a database that is a HALDB or a subsystem that is defined as dynamic allocation only is selected on the Load Entry panel. This panel displays the names of the database data sets that the function will use. Verify that the database data sets listed are the ones you want the function to use. To confirm usage of these data sets and to proceed to the next panel in the dialog, press Enter.
    • The Database Data Set Specification panel is displayed when a database that is not a HALDB and a subsystem that is not defined as dynamic allocation only is selected on the Load Entry panel. If you selected "User profile" for the Fetch DB dsnames from option, it displays the data set names saved in your user profile. If you selected "DFSMDA members" for the Fetch DB dsnames from option, it displays the data set names specified in the DFSMDA dynamic allocation members for the subsystem.
      The Database Data Set Specification panel is displayed when the Skip DB data set panel option is not selected, but it is also displayed when the Skip DB data set panel option is selected and one of the following conditions is true:
      • FM/IMS fails to obtain all the required data set names from either your user profile or the DFSMDA members.
      • One or more of the database data sets does not exist or has an invalid data set organization.

      If the displayed data set names are not the ones you want the function to use or no data set names are displayed, enter the data set names that you want the function to use and press Enter. To confirm usage of the displayed data set names and to proceed to the next panel in the dialog, press Enter once more.

  11. On the Initial Load Options panel, specify the Load from: data set details. This must be a sequential file containing data previously extracted using the FM/IMS Extract utility.
  12. If you have specified DBRC in option 0.6.1, enter the name of the data set containing the DBRC skeleton in the Image copy skeleton: Data set name field. This is used to generate an IMS image copy job for the database. Sample skeletons are found in the IMS Proclib data set.
    Note: The use of DBRC is required for HALDB databases, so this option must be selected to initialize a HALDB.
  13. If you have not yet emptied the database, select the Delete/Define DB` data sets option.
  14. If you are using DBRC and you want the JCL generated for the database to issue the GENJCL.IC DBRC command to generate an IMS image copy, select the Submit image copy option. This generated image copy job is submitted to the internal reader.

    If this option is not selected, you must run your site's external jobs to issue this command, as the database is unusable until an image copy has been run.

  15. Press Enter. FM/IMS uses the data you specified in the dialog to generate JCL for the Load job. You can edit the JCL before submitting the job. Submit the JCL.
Note:

The minimum required region size is 2M.