Rational Developer for System z

Importing a BMS map

The Import BMS map wizard allows you to create a new screen message that includes the BMS information from the BMS map. The phrase importing a BMS map means "creating a new screen message that includes BMS information from a BMS map".

This feature allows you to quickly create a screen message that contains BMS map information. You can then use the new screen message in a flow that interacts with a CICS® terminal application that uses BMS (see Working with information from BMS maps).

Note: Alternatively, you can add BMS information from a BMS map to an existing screen message that was originally created by capturing the same application screen in the host editor (see Assigning BMS field names). The resulting screen message is functionally equivalent to a screen message that was created from the BMS map, except that the descriptors in the screen description might be different.
Note: For more information about creating a new screen message from a BMS map file see the FAQs in Importing resources from BMS files.

A BMS source file (for example, dfh0xs1.bms) contains BMS map sets that in turn contain BMS maps.

To create a new screen message that includes the information from a BMS map:

  1. Open the Import BMS wizard:
    1. In the EST Project Explorer, right-click a service flow project or subproject.
    2. Select Import > BMS.

    The Import BMS wizard opens.

  2. On the first page of the Import BMS wizard, titled BMS:
    1. Select File System, Workspace, or Remote, and then select a BMS file that contains a BMS map from which you want to create a new screen message.
      Note: You can select multiple BMS files. The wizard processes all the BMS maps in all the files that you select.
    2. In the Project Name list, select the subproject in which you want to create the new screen message.
    3. Click Next to go to the next page or Finish to create the new screen message or messages.
  3. On the second page of the Import BMS wizard, titled BMS Import Options:
    1. Specify values for the following options:
      Host code page
      Select the code page that was used to create the BMS map on the z/OS® system.
      BMS file code page
      Select the code page for the imported BMS file.
      Screen size
      Select the screen size of the application screen for which you plan to use this new screen message.
      Note: This parameter is necessary because the information in the BMS map might be smaller than the application screen size
      The CICS Service Flow Runtime supports the four standard screen sizes: 24x80, 32x80, 43x80, and 27x132. If a BMS map defines a screen of nonstandard size (such as 12x40) then the service flow project tools need to know which of the four standard screen sizes the user application presents the nonstandard screen inside of, so that the runtime can process the BMS map correctly.
      Generate screen recognition criteria
      In this group, specify the descriptors that you want to be included in the default screen description of the new screen message that this wizard creates.
      Note: If there are multiple BMS maps, so that multiple new screen messages are created, this default screen description is used in each new screen message.
      The options in this group work the same way as the same-named options on the Screen Recognition Settings page of Enterprise Service Tools section of the Preferences window (see Setting the contents of the default screen description).
    2. Click Next to go to the next page or Finish to create the new screen message or messages.

  4. On the third page of the Import BMS wizard, titled BMS Overwrite Options:
    1. Specify values for the following options:

      These options determine the action that the wizard takes if it finds that the same screen message that it is about to create already exists in the destination subfolder:

      Overwrite existing screens entirely
      Completely overwrite the contents of the already existing screen message with the contents of the new screen message.
      Just merge field names
      Overwrite only the field names of the already existing screen message with the field names of the new screen message. Also, overwrite only field names that are default field names (such as Field482).
      Overwrite non-default names
      Overwrite non-default field names as well as default field names.
      Match by
      The radio buttons in this group select the standard that the wizard uses to determine whether an already existing screen message is the same screen message as a new screen message:
      File name
      The already existing screen message is the same screen message if it has the same name as the new screen message.
      Screen structure
      The already existing screen message is the same screen message if it has the same screen structure (number, location, and length of fields) as the new screen message.
    2. Click Finish.

The wizard creates a new screen message for each BMS map in the selected BMS files.

Note: If the Import BMS wizard determines that the BMS map appears to have been created using the IBM® Screen Definition Facility then the wizard opens the Import window and prompts you to click Yes or No:
  • Click Yes if you want the wizard to use the alternate field names created with the IBM Screen Definition Facility, which are stored in comment lines preceding each DFHMDF macro.
  • Click No if you do not want the wizard to use the alternate field names but instead to use the standard BMS field naming convention (the label used with the DFHMDF macro).


Feedback