Rational Developer for System z

Step 2.2: Import BMS maps

In this step you will use existing BMS maps to create two screen messages for the CICS® example catalog application (egui).
You will create screen messages for the following two application screens:

Two requirements come into play in this step of the tutorial:

Import the BMS maps

When you import a BMS map, the importer:
  1. Reads the BMS information from the map.
  2. Creates a screen description based on the BMS information.
  3. Creates a screen message to contain the screen description.
  4. Stores the screen message in a screen message file.

You can obtain the BMS maps for the CICS example catalog application from the system administrator for your host system (see Required environment, materials, and assistance). You will need the following map files:
  • DFH0XS1.BMS -- Contains the maps for the Main Menu screen and the "Details of your order" screen (the latter screen is not used in this tutorial).
  • DFH0XS2.BMS -- Contains the map for the "Inquire Catalog" screen.

Download these files from the remote z/OS® system and place them in a local directory of your workstation.

To import the BMS maps:

  1. In the EST Project Explorer, right-click the CatalogSample.Terminal subproject.

  2. Click Import > BMS. The BMS Import wizard opens.

  3. On the first page of the Import BMS wizard, titled BMS:
    1. Select the BMS files DFH0XS1.BMS and DFH0XS2.BMS:
      1. Click File System or Workspace. Depending on your choice, either the system Open window or the workbench's Browse Workspace wizard opens.
      2. Using either the Open window or the Browse Workspace wizard:
        1. Navigate to the location where the BMS map files are located.
        2. Select the files DFH0XS1.BMS and DFH0XS2.BMS.
        3. Close the Open window or the Browse Workspace wizard.

      The Import BMS wizard displays the selected files in the BMS files to import list.

    2. In the Project Name list, select CatalogSample.Terminal.

    3. Click Next.

  4. On the second page of the Import BMS wizard, titled BMS Import Options:

    1. In the Host code page list, you can use the default code page or select another.

    2. In the BMS file code page list, you can use the default code page or select another

    3. In the Screen size list, select the default screen size: 24x80.

    4. In the Generate screen recognition criteria group:
      1. Clear the check box Fields checksum descriptor if it is not already cleared.
      2. Select the check box Number of fields descriptor.
      3. Select the check box Number of input fields descriptor.

    5. Click Next.

  5. On the third page of the Import BMS wizard, titled BMS Overwrite Options:

    1. Click Overwrite existing screens entirely.

    2. In the Match By group, click File name.

    3. Click Finish.

The wizard creates three screen message files:

These new screen message files are listed in alphabetical order in their folder. To see these files, expand CatalogSample > CatalogSample.Terminal > Messages.


Terms of use | Feedback

This information center is powered by Eclipse technology. (http://www.eclipse.org)