Importing BMS map sets

ZIETrans enables you to create screen captures from Customer Information Control System (CICS®) Basic Mapping Support (BMS) map sets. BMS maps are screen definitions files for CICS. Each map defines all or part of a screen and a CICS application typically displays one or more maps to create a complete screen image. Maps contain both static and dynamic areas or fields.

The source for BMS maps is organized in groups called map sets. One map set contains one or more maps. Map sets exist in source form as one map set per source file. When ZIETrans imports BMS Maps, the import takes place at the map-set level. It is not possible to import an individual map.

Maps initially exist on the host system and must be placed on your local file system (or appear to be on the local file system) and have an extension of .bms before being imported to ZIETrans.

You must first copy the BMS map sets from the host to your local file system. This is a manual step outside of ZIETrans that can be done by either physically copying the files to the file system or by connecting the file system to the host using networking software. The file should not be transferred as a binary file. It must be readable locally on your workstation.

Click File > Import > ZIETrans > BMS map sets into ZIETrans to open the Import wizard.
Select the BMS map set files you want to import from the list and the destination of the imported files.
Click on the pull down arrow to select the country Host code page. This is the code page that was used to create the BMS map on the host.
Click on the pull-down arrow to select the BMS file code page. This is the code page used for the BMS file when it was transferred to the workstation.
You have the option to Overwrite existing maps without warning and to Generate one screen capture per map using the map name as the screen capture name.
Note: You may not want to automatically create screen captures if any of the maps need to be combined with other maps to form a screen.
You can also select Overwrite existing screen captures without warning.
Click Finish.

BMS capture files are stored in a separate Maps folder within the ZIETrans project. By default, the Maps folder is not visible in the ZIETrans Projects view unless there are imported maps. Within the Maps folder is a separate folder for each map set, and within each folder, a separate file for each map (using extension .bmc). Additionally, the original source is stored in the file system (extension .bms) and is shown in the folder containing its associated maps. You can edit the source by double clicking the file. If the source is edited and saved, the maps are automatically regenerated and overwritten except for maps that have been modified through the Properties view.

You can also import BMS maps by dragging a BMS source file into the <project>/bmsmaps folder in the Navigator view. The file must be placed directly in the bmsmaps folder and not in any subfolders. If errors occur while importing maps this way, messages will be displayed in the Problems view.

Note: The source is saved as a reference only and has no function within the project other than to be displayed in the editor. When it is displayed, the entire map set is displayed and no attempt is made to highlight the definition of the particular map that is being displayed in the editor.

After BMS maps are imported, there are several actions that can be taken from the ZIETrans Projects view.

Hovering your mouse cursor over the map name displays a small image of the map.
When you click on a map in the ZIETrans Projects view, the Properties view is updated to show details about the selected map. If there are named fields in the map, you can use the Properties view to modify the contents of those fields. By making copies of maps to alter the contents of named fields within the copies, you can create different customized versions of maps that accurately reflect the way the screen will be shown by the application.
Double clicking on a map brings up an editor page that shows how the map would display on a 3270 screen. Double clicking on the map set folder name will show the map source in an editor.
Right clicking on a map name in the ZIETrans Projects view adds a Generate Screen Captures selection to the pop-up menu. Selecting this launches the Generate screen captures wizard that can be used to select one or more BMS capture files to be used to create a screen capture. You can elect to create separate screen captures for each BMS map selected or merge selected BMS maps into a single screen capture. Maps cannot be merged if fields overlap. The Overwrite existing resources without warning check box can also be selected if needed.
Note: If separate screen captures are generated and more than one file is selected, the names of the screen capture files are generated automatically.

Once your screen captures have been created, you can begin to create ZIETrans screen events.