Loading into an initialized database

You can use the No replace or the Replace option to load data into a database that has been initialized or already contains data. These options can be used in conjunction with a Static or Dynamic PSB.

To load data into an initialized IMS database:

  1. Select option 3 Utilities from the Primary Options Menu and then option 4 Load from the Utility Menu. The Load Entry panel is displayed.
  2. Notice that many of the fields on the Load Entry panel are also on the Browse Entry panel. To fill out the fields that are common to both panels, follow one of these sets of instructions according to which Region type and PSB type you want the Load to use:
  3. In the Load type field, enter either 1 if you do not want the Load to replace existing database segments or 2 if you do want existing segments replaced with the load segment.
  4. 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.
    • PSB Selection panel
      • Displayed when you enter no PSB name or a PSB name pattern and select "Static" for PSB type.
      • Displays a list of the PSBs in the PSB libraries for the specified subsystem.

      If the PSB libraries for the subsystem are not fixed, you specify the PSB libraries for the subsystem on the PSB and DBD Data Sets panel (option 0.6.7). If the PSB libraries for the subsystem are fixed, the FM/IMS administrator specifies the PSB libraries for the subsystem at installation time.

    • PCB Selection panel
      • Displayed when you select Static for the PSB type and one of the following is true:
        • You enter no database name and there is more than one database PCB in the specified PSB or
        • You enter a database name and there is more than one PCB for the database in the PSB or
        • You enter a database name pattern and the PSB has PCBs for databases with names that match the pattern
      • Displays a list of the PCBs in the specified PSB.
    • Database Selection panel
      • Displayed when you enter no database name or a database name pattern and select "Dynamic" for PSB type.
      • 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.

    • AGN Selection panel
      • Displayed when all of these are true:
        • You select "BMP" for Region type
        • the specified subsystem uses AGNs and has some of them listed in the FM/IMS installation options module.
        • You enter no AGN name or an AGN name pattern.
      • Displays the AGNs for the subsystem that are listed in the FM/IMS installation options module.

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

  5. If you selected "DLI" for Region type and 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.

  6. On the 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.
  7. 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.