Importing IMS resources from your local file system

You can import IMS™ resources such as program specification block (PSB) and database description (DBD) files into your IMS Explorer project from your local file system by using the Import IMS Resources wizard.

Before you begin

  • Create an IMS Explorer project, or have an existing IMS Explorer project in your workspace.
  • Transfer the PSB and DBD source files from your z/OS® environment to your local workstation by using FTP.

Procedure

To import IMS resources into an IMS Explorer project:

  1. From the main menu bar, click File > Import > IMS > IMS Resources. (You can also import IMS resources by right-clicking an existing project in the Project Explorer view, and clicking Import > IMS > IMS Resources.)
  2. In the Project name field, select the name of an IMS Explorer project and click Next.
  3. In the Import IMS Resources wizard, select Local file system.
  4. Specify whether you want the import wizard to automatically search for DBDs that are referenced by the DBDs or PSBs that you will select to import on the next page of the wizard. Click Next.
  5. Select the PSB and DBD files that you want to import.
    1. To import PSB files, click Add PSB, select the PSB files, and click Open to select the files to import.
      Tip: To select multiple files, press Shift and click the first and last files in the list that you want to select. To select multiple files that are not grouped, press Ctrl and click the files in the list.

      If the PSB file is valid and you selected the check box to search for referenced DBDs, IMS Explorer searches for any DBD files that are referenced by the PSB in the same file directory or subfolder within the directory, and selects them to be imported into the project.

      Restriction: IMS Explorer only automatically finds files if the file name matches the DBD name.

      If you did not select the check box to search for referenced DBDs or if the imported PSB file references any DBDs that are not in the same file directory or subfolder within the directory as the PSB file, the missing DBDs are listed in the DBDs to import for selected PSBs or DBDs table. Click Add DBD to add the missing DBD files.

      Tip: If the imported PSB source files use an illegal character in the PSB name, the wizard prompts you to open the Add or Edit PSB Template Definitions wizard to specify a replacement character for the PSB name.
    2. To import DBD files into the project, click Add DBD. You can import any DBD into your project, even if it is not listed in the DBDs to import for selected PSBs or DBDs table.
      The missing DBDs are listed in the DBDs to import for selected PSBs or DBDs table for one of the following reasons:
      • You did not select the automatic search for referenced DBDs.
      • The imported PSB or DBD file references DBDs that are not in the same directory.
      Click Add DBD to add the missing DBD files.
  6. Click Finish.

Results

An IMS program definition model is generated for each PSB that is successfully imported and saved in the PSB folder, with the PSB name and the .psb extension. Similarly, for each DBD file that is successfully imported into an IMS Explorer project, an IMS database definition model is generated and saved in the DBD folder, with the DBD name and the .dbd extension.




© Copyright IBM Corporation 2010, 2017.