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.
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:
- Open the Import BMS wizard:
- In the EST Project Explorer, right-click a service flow project
or subproject.
- Select .
The Import BMS wizard opens.
On the first page of the
Import BMS wizard,
titled
BMS:
- 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.
- In the Project Name list, select the subproject
in which you want to create the new screen message.
- Click Next to go to the next page or Finish to
create the new screen message or messages.
On the second page of the
Import BMS wizard,
titled
BMS Import Options:
- 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).
- Click Next to go to the next page or Finish to
create the new screen message or messages.
On the third page of the
Import BMS wizard,
titled
BMS Overwrite Options:
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.
- 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).