rdz workbench - bms map editor.pptx

8/11/2019 RDz Workbench - BMS Map Editor.pptx

1/80

IBM Software Group

2011 IBM CorporationUpdated March, 2011

RDz WorkbenchBMS and MFS Map Editors

Jon Sayles, Rational System z Produc ts -jsay [email protected] .com
mailto:[email protected]:[email protected]


2/80

2

IBM Trademarks and Copyrights Copyright IBM Corporation 2007,2008, 2009, 2010, 2011. All rights reserved.

The information contained in these materials is provided for informational purposes only, andis provided AS IS without warranty of any kind, express or implied. IBM shall not beresponsible for any damages arising out of the use of, or otherwise related to, thesematerials. Nothing contained in these materials is intended to, nor shall have the effectof, creating any warranties or representations from IBM or its suppliers or licensors, oraltering the terms and conditions of the applicable license agreement governing the useof IBM software. References in these materials to IBM products, programs, or services donot imply that they will be available in all countries in which IBM operates.

This information is based on current IBM product plans and strategy, which are subject tochange by IBM without notice. Product release dates and/or capabilities referenced inthese materials may change at any time at IBMs sole discretion based on marketopportunities or other factors, and are not intended to be a commitment to future productor feature availability in any way.

IBM, the IBM logo, the on-demand business logo, Rational, the Rational logo, and other IBMRational products and services are trademarks or registered trademarks of theInternational Business Machines Corporation, in the United States, other countries orboth. Other company, product, or service names may be trademarks or service marks ofothers.


3/80

3

Course Contributing Authors Thanks to the following individuals, for assisting with this

course:

David Bean/IBM

Russ Courtney/IBM

Gayatri Renganathan/IBM


4/80

4

Course Overview

Audience This course is designed for application developers who have learned or programmed in

COBOL, and who need to do z/OS Traditional Development and Maintenance as well asbuild leading-edge applications using COBOL and Rational Developer for System z.

Prerequisites This course assumes that the student has a basic understanding and knowledge of

software computing technologies, and general data processing terms, concepts andvocabulary, as well as a working knowledge of COBOL and z/OS.

Knowledge of SQL (Structured Query Language) is assumed for database access isassumed as well.

Basic PC and mouse-driven development skills, terms and concepts are also assumed


5/80

5

Note to IMS TM and MFS Developers

Appendix A contains material on using the

RDz's graphical MFS editing tools

They are almost exactly the same as the BMStools

Because of this, the recommendation is thatyou read through the content in the RDz/BMS

Map Editor section

And then proceed to the Appendix on MFS


6/80


7/807

UNIT

Topics:

The RDz Workbench

BMS Terms and Concepts

RDz/BMS Map Editor

Appendix


8/808

Objectives

After completing this unit, you should be able to:

Describe the types of 3270 data streams available to CICS applications

Define the three BMS macros

Define an "attribute byte"

Describe how to code BMS macros (manually)

List a few of the BMS field macro attributes


9/809

Brief Mini-Tutorial on BMSBefore jumping into RDz's BMS Map Editing

features, if you're no t familiar with the BMS

macro language it might be a good use of

10-15 minutes of your time to read the slidesin this mini-tutorial on BMS terms and

concepts and vocabulary

Don't be a fake BMSdeveloper read on!


10/8010

"Real" BMS Developers

- Caveat

It must be noted that, while this section willassist you with the terms and concepts

pre-requisite to using RDz's BMS Map

Editor, if you are truly aspiring towards

becoming a BMS-guru, you will need

either:

A legitimate class in BMS per se'http://www-949.ibm.com/software/rational/cafe/docs/DOC-2895

or

You will have to do a lot morereading of books, or sources like this:

http://publib.boulder.ibm.com/infocenter/cicsts/v3r1/index.jsp?topic=/co

m.ibm.cics.ts31.doc/dfhp3/dfhp3bj.htm
http://www-949.ibm.com/software/rational/cafe/docs/DOC-2895http://publib.boulder.ibm.com/infocenter/cicsts/v3r1/index.jsp?topic=/com.ibm.cics.ts31.doc/dfhp3/dfhp3bj.htmhttp://publib.boulder.ibm.com/infocenter/cicsts/v3r1/index.jsp?topic=/com.ibm.cics.ts31.doc/dfhp3/dfhp3bj.htmhttp://publib.boulder.ibm.com/infocenter/cicsts/v3r1/index.jsp?topic=/com.ibm.cics.ts31.doc/dfhp3/dfhp3bj.htmhttp://publib.boulder.ibm.com/infocenter/cicsts/v3r1/index.jsp?topic=/com.ibm.cics.ts31.doc/dfhp3/dfhp3bj.htmhttp://www-949.ibm.com/software/rational/cafe/docs/DOC-2895http://www-949.ibm.com/software/rational/cafe/docs/DOC-2895http://www-949.ibm.com/software/rational/cafe/docs/DOC-2895http://www-949.ibm.com/software/rational/cafe/docs/DOC-2895http://www-949.ibm.com/software/rational/cafe/docs/DOC-2895


11/8011

What is BMS?

CICS

YourApplication

Program

Terminal Control

Data Stream

Basic Mapping Support

Macros

There are two ways for your program to communicate to a 3270-

type terminal:

1. Terminal Controldevice-dependent data stream

2. Basic Mapping Support (BMS)macro-based device-

independent service

Green Screen3270 Terminal

Of the two, BMS is the

predominant 3270/CICS

technology


12/8012

3270 Terminal CharacteristicsVocabulary

A 3270 terminal device is a field oriented displayScreen divided into user defined fields

Each field has characteristics, determined (programmed) byATTRIBUTE BYTESwhich assume the first character of each field

Each attribute byte is displayed as a space, but it is NOT available for data entry

With BMS you send andreceive data to/from 3270

terminals using BMS maps

Field

AttributeBytes


13/8013

BMS MapMapset, MAPs and Fields

BMS Mapset definition

BMS Map definition

BMS Field definitionAttribute

Attribute


Attribute


Attribute

A complete BMS map iscomposed of a Mapset,Map and individual

defined fields A Mapsetdefines the

MAP(s) used by program

A MAPprovides forscreen formatting

Maps consist of one-to-many Fielddefinitions

A MAPSETis group ofscreens (1 or moreMAPs)

Normally there isonly one MAP perMAPSET

Only three macros usedto create a BMS map

See next slide

Usually a ScreenGenerator (like RDz'sScreen Painter) is usedto develop BMS screens

B

M

S

M

a

p

3270

Terminal


14/8014

BMS MapsetThree Native Coding MacrosBMS (native coding) uses assembler

macros to define screen layout(s)

1. DFHMSD= mapsetdescriptor (one per mapset)

2. DFHMDI= map descriptorinitiator (one per map)

3. DFHMDF= map descriptorfield (one for each map field)

Note: DFH= Always means"CICS"

BMS

Macros

Labels Attributes


15/80


16/8016

Define a Mapset

To define the mapset.

DFHSMD TYPE=(type of mapset),MODE=,

CTRL=FREEKB, (Note: FREEKB is the default)

LANG=,

TIOAPFX=YES,

To end a mapset definition

DFHSMD TYPE=FINAL

other Map and Field macros

See Notes

Mapset name

Note: in most cases

should limit to seven

characters


17/8017

Define a Map

MENU013 DFHMDI SIZE=(24,80),

LINE=1,

COLUMN=1 (notedefaults)

The DFHMDI macro defines the physical

characteristics of the 3270 screen:

Screen size

Start byte (Line=1,Column=1)

etc.

24

Lines

80Columns


18/8018

Define FieldsDFHMDF POS=(7,10),

LENGTH=10,

INITIAL='LAST NAME:',

ATTRB=ASKIP

LNAME DFHMDF POS=(7,21),

LENGTH=20,

ATTRB=(UNPROT,IC)

MESSGE DFHMDF POS=(5,10),

LENGTH=64,

ATTRB=(PROT,BRIGHT)

Field

Label

Field

Macro

Statement

See Slide Notes

Continu

ation

Col. 72


19/8019

BMS Quiz

MAPSET1 DFHMSD LANG=COBOL,

MAPA DFHMDI SIZE=(32,80)

DFHMDF POS=(2,31),

INITIAL=My 3270 Map,

DFHMDF POS=(5,9),

INITIAL=Enter Key

LNAME DFHMDF POS=(7,21),

LENGTH=20,

ATTRB=(UNPROT,IC)

MESSGE DFHMDF POS=(5,10),

LENGTH=64,

ATTRB=(PROT,BRIGHT)

MAPB DFHMDI SIZE=(24,80)

MAPSET1 DFHMSD TYPE=FINAL

END

Based on the BMS statements below,Fill in the screen capture on the left, with the proper names for the Mapset/Map(s) where the

underscores currently exist. Then answer the following questions:

What are the names of the two BMS maps?

What is the size of the MAPB3270 device?

Where is the cursor initially going to be placed?

What are the names of the four fields in MAPA?

Where will "Enter Key" be placed on the 3270 screen?

What does the PROT attribute do for a field?


20/8020

Objectives

After having completed this unit, you should now be

able to:

Describe the types of 3270 data streams available to CICS

applications

Define the three BMS macros

Define an "attribute byte"

Describe how to code BMS macros (manually)

List a few of the BMS field macro attributes


21/8021

UNIT

Topics:

The RDz Workbench

BMS Terms and Concepts

The RDz BMS Map Editor Appendix


22/8022

Objectives

After completing this unit, you should be able to:

List the features of the BMS map editor

Use the BMS map editor to create several different kinds of BMS screens

Describe how to import existing BMS maps

Show how to generate BMS maps

List the outputs of the generate process

Describe how to deploy BMS maps on z/OS

Describe how to run and test BMS-map applications

The RDz Help system has excellent documentation

From the menu:Help > Help Contents Search on: Using the BMS Map Editor

From the inline help on the BMS Map Editor, check out the Tutorial

available as a hyper-link in the help text

and a tutorial on using the BMS Editor
http://images.google.com/imgres?imgurl=http://acda.org/files/help.jpg&imgrefurl=http://www.healthkicker.com/709036336/help-me-help-my-mom/&usg=__sLzNxnEXXFvc_zakdwNOjOWZNec=&h=336&w=418&sz=41&hl=en&start=4&sig2=od9E94btqlMG2PDdI3ApmA&tbnid=nUS4N-zJErzaBM:&tbnh=100&tbnw=125&prev=/images?q=help&gbv=2&hl=en&ei=K8CCSrv8Fs3bmQfXqpWdCw


23/8023

Coding a BMS Mapset vs Creating a BMS Mapset

Options for BMS developers

1. Grueling native BMS hand-coding

2. RDz Drag & Drop

Development


24/8024

Loading a BMS Mapset into the Design Canvas

The BMS editoropens on a filerecognized as a

BMS map set.

For an existing z/OSfile, the file or

dataset must:Be named with an

extension of .BMS

or be mapped to a.bms file extensionusing the z/OS

Mapping Systemview Recall from a previous unit

(RDz Workbenchandz/OS Debugging) how tomap an MVS file-type to aWorkstation file extension

E li T li /F t d th BMS Edit


25/8025

Eclipse Tooling/Featuresand the BMS Editor All of the graphical capabilities of Eclipse can be utilized effectively:

Multiple, windowed editing frames

Select/Cut/Copy/Paste between editing frame

Etc.

Th O tli Vi


26/8026

The Outline ViewJust like the rest of the file

editing you've done thisweek, the Outlineview

synchronizes with yourdevelopment activity, andcan be used effectively

Features:

Synchronized selection

between the Outlineview and editor

You can navigatethrough the Outline viewand:

Select

Cut

Copy

Paste

Delete

Note that theseoperations will affect theBMS source macros

Th BMS M Edit O i


27/80

27

The BMS Map EditorOverviewMap Editor Toolbar

Palette(Tools)

Viewingmodes

Design Canvas

Row, ColumnRulers

Let's start by looking at the different Viewing modes

S Vi M d


28/80

28

Source View Mode

Displays your BMS file insource (macro/assembler)modeCustomized color highlighting

Line numbers

Syntax error markers

Field selection ismaintained betweenDesignSource mode

At any time during yourBMS work you can flipfrom DesignSource

Previewmode

S Vi M d C t t M O ti


29/80

29

Source View ModeContext Menu Options

Standard source-leveldevelopment editing options

available:Save

Cut

Copy

Paste

Shift Right/LeftSnippets

Compare/Replace With (next slide)

Also, good in-place syntax validation

Source View Mode


30/80

30

Source View Mode

Compare/Replace With Options

Same functionality as the LPEX editor for source files

P i M d


31/80

31

Preview Mode Here is the same BMS

dataset in Previewmode

Note that we have setToggle Sample Values"on"in Design mode, for thisscreen capture

Preview mode is basicallyfor screen documentation,design-reviews andprototyping your 3270-U.I.

There is no applicationCOBOL/CICS Send/Receivelogic executing

But you could use Preview

mode effectively duringU.I. Design/JAD sessionswith business users

Most of your work will be done using the Design Modeso let's return to that, and see what it

has to offer BMS developers

Th BMS M Edit D i M d


32/80

32

The BMS Map EditorDesign ModeMap Editor Toolbar

PaletteTools &Widgets

Design Canvas

Provides "declarative

development"facilities for

paint ing3270/BMS screens,

or doing:Screen maintenance

Mapset development (from scratch)

We'll continue by looking at the Map Editor Toolbar display options

BMS Edit T lb Di l O ti (P t 1 f 2)


33/80

33

BMS EditorToolbar Display Options (Part 1 of 2)

Display options enableyou to control how

Mapsets are displayedin the editor at designtime.

Sizedrop-down list toselect a new size for theMap

Toggle Gridlinesshows or hides a gridover the form to help insizing and arranging fields

Toggle Sample Valuesshows or hides samplevalues for input fields,which are otherwiseinvisible unless they havethe Initialproperty

specified

Note:Feel free to try any/allof these design and display

options while reading through

these slides

BMS Edit T lb Di l O ti (P t 2 f 2)


34/80

34

BMS EditorToolbar Display Options (Part 2 of 2)

Display options enableyou to control how

Mapsets are displayed inthe editor at design time.

Toggle Black and WhiteModeswitches the editor

between black and whitemode and full color modeusing the default backgroundcolor

Zoom levelsets themagnification level of theeditor

Filters(see next slide)

BMS Edit Filt


35/80

35

BMS EditorFilters

Filters enable you to:

Focus on just oneMap within a

Mapset

Review theappearance of apopup form andits underlying

form

Select or deselectto filter the formsyou want toinclude in the

default filter

Note that if your Mapsets contain one MapFilters will not be as useful an optionas others you will come across

BMS Editor Palette View


36/80

36

BMS EditorPalette View

SelectAllows you to select a field and sets focus on that field

MarqueeAllows you to select multiple fields at once

MapSelect this option to create a new Map within a MapsetConstant Fieldsdisplay a string of text that does not change in a Map. Unlike

variable fields, constant fields cannot be accessed by you COBOL or PL/I code

Variable Fieldsserve as input or output data in a Map. Each variable field is basedon an COBOL field. Variable fields can be accessed by your COBOL or PL/I code

Advancedassist you in creating standard but more complex text form elements suchas arrays, records.

Used to add new BMS elements (Maps and Field elements)to a BMS screenby dragging and dropping onto the Design Canvas

BMS Map Enhancements Using the Palette 1 of 6


37/80

37

BMS Map EnhancementsUsing the Palette1 of 6 Let's add phone# as a new literal and field to BADD400.BMS. To that we'll:

Select and move the existing/related Salary fields down two rows

Add a literal and input field

Selecting and dragging BMS fieldsoptions:To select a single field, simply:

Left-Click the field to set focus

(Holding down the left mouse button) Drag the field to its destination

To select multiple fields:

Hold down the Ctrl key

Left-Click each field you wish to select

(Holding down the left mouse) Drag the fields to their destination

Or use the Marquee selector:

Click the Marquee selector (this allows you to "lasso a rectangular group of fields)

(Holding down the left mouse button) Lasso the fields and select them

Change selector back to an arrow pointer

(Holding down the left mouse button) Drag the field to its destination

Note that you could also use your PC's up/down/right/left arrowsto select (not move, just select) fields in your BMS map

Using the Palette 2 of 6 Adding New Fields


38/80

38

Using the Palette2 of 6Adding New FieldsAdd a new Label to Row 16, column 4 - from the PaletteLeft-click to select: Label

Holding down the left-mouse button

Drag the mouse pointer to:

Row: 16

Column: 4

Drop

Type in the label's text: PHONE:

A few things:You will notice that the widget's color is blue (not turquoise). This can be:

Changed for this one label (next slide)

Changed for all new labels (from BMS Editor Preferencescovered in a bit)

If you make an mistake and drop the field in the wrong placeor you type something elsethat needs fixing, you will find it easy to modify every element of your BMS field

Next slide

Using the Palette 3 of 6 Customizing Field Properties


39/80

39

Using the Palette - 3 of 6 - Customizing Field Properties

The BMS Editor allows you to modify every element ofyour screen using a consistent Properties dialog

Right-click over the field

Select Field Properties

From Field Propertiesyou can customize virtuallyany element of a BMS screen field:

From Basic:

Enter BMS field name

Note that labels arerarely named in

BMS maps

Add a comment

Alter the layout R/C

Change field length

Modify initial value Change color

Click the color

tablet

The Field Properties dialog isavailable for new, or existing

(from an imported BMS) map fields

Using the Palette 4 of 6 Additional Field Properties


40/80

40

Using the Palette4 of 6Additional Field Properties Besides Basic there are three additional

Field Propertiesdialogs:

Presentation:

Intensity, Highlighting, Transparency Different types of boxed outlines

Attributes:

Disabling/Enabling data entry

Adding Validation logic

Advanced:

Gives you control over the creation of COBOL group data

structures to handle sub-elements of a field with individual

variablesyet be able in COBOL to address the entire group as

a single structure

Example: mm / dd / yyyy - could be thought of a single date group

field, composed of five elementary items (see Slide Notes)

Using the Palette 5 of 6 Add an Input Field


41/80

41

Using the Palette5 of 6 Add an Input FieldAdd a new Input Field to Row 16, column 11 - from the PaletteLeft-click to select: Input Field

Holding down the left-mouse button

Drag the mouse pointer to:

Row: 16

Column: 11

Drop

(optional) Using your mouse, stretch (resize) the new input field as shown

Customize the input field's properties: As shown in the screen captures here

Orfeel free to experiment with your own options for

this new field (this is not a production map)

Using the Palette 6 of 6 Finished Enhancement


42/80

42

Using the Palette6 of 6 Finished EnhancementAddedPhone

number field withliteral label andinitial value

If you already knowBMS, consider lookingat the Sourceview tosee what has beengenerated for yourFields

SuggestionSpend a few minuteswith either the classBMS file or your ownthrow-away dataset, toexperiment with these

and other options fromthe toolbar/Palette

Defining Table Structures


43/80

43

Defining Table Structures Three options exist for creating BMS U.I. tables

Each option is a little different.

However for all: A wizard lets you define the field specification.

The array is created starting at the location of the mouse-click

Field name validation is provided.

Overlap on the screen is also detected

1. Array

Define a single field that will be repeated on the screen a specified number of times either verticallyor horizontally.

2. Table Define a single-or-multi-dimensional table of fields

3. Structure The Structure palette item allows you to define a structure of one or more fields, and also specify

the number of times this structure needs to be repeated on the screen. The structure is repeated vertically on the screen

You must specify the row and column offset for each of the field in the structure. These offsets arefrom the point of the original mouse-click on the screen

We will show examples of each. You can decide based on yourrequirements and experience which to use in your production BMS.

Define an Array


44/80

44

Generated BMS statements

Define an ArraySteps:1. Ensure that space is available on your Map

2. Drag & Drop an Array widget from thePalette to your Map location

3. Respond to the prompts:

NameFieldname

LengthIndividual field length

Distance:

If Vertical, # of rows between fields

If Horizontal, # of columns between fields

Array direction

Array U.I.in Design view

Define a Table 1 of 2


45/80

45

Define a Table1 of 2Respond to the prompts in the

first dialog:

Number of rows

Number of columns

For each column to be added:

- ClickAdd

- Enter the Column Header,Width and Field name Be sure that the Width is wider

than the Column header literal

- Specify Input(y/n)

- Can Edit or Remove columnsduring this dialog

Define a Table 2 of 2


46/80

46


Define a Table2 of 2Completed Dialog (Click Finishwhen done)

Can create header row with separator

Table U.I.in Design view

Define a Structure 1 of 2


47/80

47

Define a Structure1 of 2Respond to the prompts in the

dialogs and click Finish Structure name

How many row occurrences For each column:

Click Add.. And specify:

Field name:

Field width

Row offset:

How many blank rows togenerate between data rows

Column offset: Number of bytes (you

calculate) to the right, relative

to the first column in the

structure

Can Edit enteredspecifications

Can also: Remove

Move columns to the right or

left by selecting: Up/Down

Define a Structure 2 of 2


48/80

48

Define a Structure2 of 2

Finished Dialog from previous slide


Structure U.I.in Design view

The BMS Map Editor Context Menu 1 of 2


49/80

49

The BMS Map EditorContext Menu1 of 2

The context menu has a few additional

capabilities when in Designview:

Show Sample ValuesSelect field(s)

Alignment options

Format options

Same as the Properties dialogs

Design View mode

with Show Grid



50/80

50


Other Context Men options continued:

Print (to local printer)

Show Source (context sensitive):Of fieldOf Map

Print

Show Source

BMS Form Editor Properties and Outline Views


51/80

51

BMS Form Editor Properties and Outline ViewsThe Properties

view displays theBMS propertiesof the Mapset,

Map, or field thatis currentlyselected in theeditor.

The Outlineviewdisplays a hierarchicalview of the Mapset thatis open in the editor.

The RDz views aresynchronized with what isselected in the BMS editor

*** See Slide Notes

See Notes

Creating a New BMS Mapset


52/80

52

Creating a New BMS Mapset

Besides maintaining existing BMS, you may wish tocreate completely new Mapsets/Maps using the

BMS editor. Here are the steps:

1. Create New BMS Mapset and Map

2. Customize the Map Properties

3. Use the Palette widget tools (as shown before) to create

individual BMS fields and to customize field properties

OptionallyYou can generate JCL for assembling yourmap using z/OS project tooling

AndYou can customize the BMS map editor's preferences

1 Create New BMS Mapset


53/80

53

1. Create New BMS Mapset

From the File menu, select:

1. New > Other

2. From the New dialog, type:Map

and select BMSMap Set

3. Select a Folder for your new Mapset (if created on z/OS), or ifcreating on your workstation, select a Project location

4. Enter high-levelMap Set properties

5. Click Finish

New Mapset and Map 1 of 4


54/80

54


After you click finish in the new Map Set wizard, a new file will be created and yournew Mapset and default Map combination will open into the Design Canvas.

Customize the Map Properties from the Context Menu



55/80

55


You can use the same Propertiesdialogs, to customize your Map's BMSmacros:

DFHMSD

DFHMDI



56/80

56


Map and Mapset property customization, continued



57/80

57


Consider viewing thenew Mapset in theSource mode

If for no other reasonthan to gain anunderstanding ofcause/effect in settingthe Map/Mapsetcustom properties

Use the Palettewidget tools (asshown before) tocreate individualBMS fields and tocustomize field

properties


58/80

58

UNIT

Topics:

The RDz Workbench BMS Terms and Concepts

The RDz BMS Map Editor Generating Symbolic and Physical Maps

Appendix

Generating Your BMS Maps


59/80

59

Generating Your BMS Maps There are a couple of ways of generating the symbolic maps for BMS Maps.The first option is via the JCL generation and submitting the generated JCL.

This will give both the symbolic map and the physical map.

The second option (valid only for generating COBOL copybooks) is done without actuallyassembling the BMS macros.

This is valid for both local and remote BMS resources.

How to:

Select any BMS file,

Right-click and Generate > Symbolic map

A similar function is available for MFS files also (as of RDz7.6 release).Again, this is only valid for COBOL for now. IBM has open requirements for similar support

for PL/1.

Slide Notes

Property Groups and Generated JCL for a Mapset


60/80

60

p y p p

You will probably need to customize the High-level qualifier for the Object and Load(DSCTLIB) libraries

The default is for the generated JCL to pick up your own

Property Groups and Link Options for a Mapset


61/80

61

You will probably also need to customize theHigh-level qualifier for the Load Modulelocation on the Link Options

The default is for the generated JCL to pickup your own Load lib.

Although you can point to a library in theCICS RPL (Relocate-able Program Library)concatenation list

The Application Entry Point Properties


62/80

62

e pp ca o y o ope es Right-click over the

folder name andselect Properties

Be sure to specify

High Level Assemblerfor your BMS

Building the Mapset -Symbolic map


63/80

63

1. Generate JCL for

Assemble

2. Add a suffix to the JCL

member name

3. Submit the JCL

4. Check the JES output forreturn codes

5. Symbolic map now

available for program

compile

Symbolic map

Building the Mapset - Physical Map


64/80

64

1. Generate JCL for

Assemble Link

2. Add a suffix to the JCLmember name

3. Submit the JCL

4. Check the JES output forreturn codes

5. Physical map now

available for use in CICS

load library

Viewing maps on CICS


65/80

65

g p

1.Place physical map set file in a CICS RPL library

Can be targeted by Link Options property Load Module

Location2.Define the map set resource to CICS

CEDA DEFINE MAPSET(myset) GROUP(mygroup)

3.Make the new map set resource available

CEDA INSTALL GROUP(mygroup)4.View a map in the map set, under CICS

CECI SEND MAP(mymap) MAPSET(mygroup)

Using BMS maps in a CICS COBOL program


66/80

66

g p p g

1. Create the symbolic and physical maps first

Assemble-Link JCL

2. Typically use COPY statement to include the map fields in theData Definition section of the program

3. Compile COBOL program, including CICS option

4. Define both program and map set to CICS

CEDA DEFINE PROGRAM(myprog) GROUP(mygroup)CEDA DEFINE MAPSET(mymapset) GROUP(mygroup)

5. Define transaction to initiate the program

CEDA DEFINE TRANSACTION(mytr) GROUP(mygroup)

6. Install resources

CEDA INSTALL GROUP(mygroup)

7. Execute transaction!

mytr

BMS Palette, Widget Field Preferences


67/80

67

, g

All BMS Editor settings can be

customized. Especially useful

are:Default names

Palette widget entry Properties

Checkpoint


68/80

68

p

1.True or False: BMS produces a device-dependentdata stream

2.What are the two types of output from BMSassemblies?

3.How can you make an existing map set open into

the BMS Map Editor?4.Which view displays a list of BMS elements that you

can select and drop onto the Design tab?

5.What Application Entry Point property is used for amap set assembly?

6.Which Generate JCL option on the map set createsthe physical map needed for execution?

WorkshopFour BMS MAPS


69/80

69

p

In the Slide Notes is sample BMS code for four simple3270/BMS screens:

BADD400

BMEN400

BINQ400

BDLT400

From z/OS Projects:

Create a \bms\ folderInside the \bms\ folder:

Create four new files

one for each of the

BMS source files in the

Slide NotesSave each file

Use .bmsas the file's

extension

Ensure there are no

syntax errors

WorkshopUsing the Sample BMS Provided


70/80

70

Return to the slides in this unitstarting with:Loading a BMS Mapset into the Design Canvas

Follow the steps and/or directions on the slides to:View BMS in different modes: (Design/Source/Preview)

Maintain a BMS Mapset:

Move fields in a map to different locations

Add fields

Set custom properties

Change field sizes

Align fields

Define complex fields:

Arrays

Tables Structures

Create a new BMS map from scratch

Optionally customize your project properties toGenerate JCL to assemble your BMS Mapset

Summary


71/80

71

y

Having completed this unit, you should be able to:

Describe the function of BMS maps

Describe the components of BMS maps

Show the features of the BMS map editor

Describe how to import existing BMS maps

Show how to generate BMS maps

List the outputs of the generate process

Describe how to deploy BMS maps on z/OS

Describe how to run and test BMS-map applications


72/80

IBM Software Group


Appendix A

MFS Map Editor Brief Overview

MFS Map Editor


73/80

73

For IMS TM, RDz supports graphical MFS map editing in ways almost exactly thesame as the BMS editor feature/function described in this section

This section briefly discusses the differences

MFS Editor / BMS Editor Consistent Tooling


74/80

74

Same tooling between the BMS and MFS editors:Graphical frameset/rulers/etc

Design/Source/Display tabswith selected field integration between Design and Source

Toolbar

Outline view

Context menu

Show source

Similar:Palette

Preferences

MFS Toolbar


75/80

75

Similar tools:

Selection

MFS/BMS specific macros:

DEV

DIV

DIF

DOF

MID/MOD

Fields

MFS Editor

Properties


76/80

76

The Properties view isused to aggregate allMFS field:

Basic attributes Name

Attributes

Extended Attributes

EATTR

Features

MSF Properties


77/80

77

Context-selection dependent

For a Field:

Basic definition values

ATTR

EATTR

MFS Editor Properties

DEV


78/80

78

For other MFS macros, theProperties view will changeto reflect whatever is selected


79/80

IBM Software Group


Appendix B

Output from the BMS Mapset Assembly

Output from BMS Mapset Assembly


80/80

The Mapset module is assembled twice to produce different

outputs:

1) TYPE=DSECT (symbolic map) causes the generation of the

variable field layouts (data structures). These are copied

into the source program at compile time for access by the

program logic. This output is typically placed in a copybooklibrary.

2) TYPE=MAP (physical map) causes the generation of an

encoded file used at runtime for merging of constants and

variable data. This output is placed in the CICS applicationload library, and is defined as a MAPSET resource to CICS.

The TYPE= option can be set in the DFHMSD macro, or

overridden by the SYSPARM option in the assembler proc

rdz workbench - bms map editor.pptx

Documents