® IBM Software Group © 2014 IBM CorporationUpdated August, 2014 RDz Workbench – MFS Map Editors Jon Sayles, Rational System z Products -

2 IBM Trademarks and Copyrights © Copyright IBM Corporation 2007,2008, 2009, 2010, All rights reserved. The information contained in these materials is provided for informational purposes only, and is provided AS IS without warranty of any kind, express or implied. IBM shall not be responsible for any damages arising out of the use of, or otherwise related to, these materials. Nothing contained in these materials is intended to, nor shall have the effect of, creating any warranties or representations from IBM or its suppliers or licensors, or altering the terms and conditions of the applicable license agreement governing the use of IBM software. References in these materials to IBM products, programs, or services do not 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 to change by IBM without notice. Product release dates and/or capabilities referenced in these materials may change at any time at IBM’s sole discretion based on market opportunities or other factors, and are not intended to be a commitment to future product or feature availability in any way. IBM, the IBM logo, the on-demand business logo, Rational, the Rational logo, and other IBM Rational products and services are trademarks or registered trademarks of the International Business Machines Corporation, in the United States, other countries or both. Other company, product, or service names may be trademarks or service marks of others.

3 Course Contributing Authors  Thanks to the following individuals, for assisting with this course:  Gayatri Renganathan/IBM

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 as build 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 and vocabulary, as well as a working knowledge of COBOL and z/OS.  Knowledge of SQL (Structured Query Language) is assumed for database access is assumed as well.  Basic PC and mouse-driven development skills, terms and concepts are also assumed

5 UNIT Topics: The RDz Workbench   MFS Terms and Concepts The RDz MFS Map Editor  The RDz MFS Map Editor  Appendix

6 Objectives After completing this unit, you should be able to:  List the features of the MFS map editor  Use the MFS map editor to create several different kinds of MFS screens  Describe how to import existing MFS maps  Show how to generate MFS maps  List the outputs of the generate process  Describe how to deploy MFS maps on z/OS  Describe how to run and test MFS-map applications The RDz Help system has excellent documentation Using the MFS Map Editor From the menu: Help > Help Contents Search on: Using the MFS Map Editor From the inline help on the MFS Map Editor, check out the Tutorial – available as a hyper-link in the help text and a tutorial on using the MFS Editor

7 Coding … vs. … Creating an MFS MAP Options for MFS screen developers…  1. Grueling, native MFS hand-coding …   2. RDz Drag & Drop Development…

8 Loading an MFS MAP into the Design Canvas  The MFS editor opens on a file recognized as an MFS map type.  For an existing z/OS file, the file or dataset must: Be named with an extension of.MFS … or be mapped to a.MFS file extension using the z/OS Mapping System view RDz Workbench – and z/OS Debugging Recall from a previous unit (RDz Workbench – and z/OS Debugging) how to map an MVS file-type to a Workstation file extension 

9 Eclipse Tooling/Features – and the MFS Editor  The graphical capabilities of Eclipse can be utilized effectively:  Context menu  Multiple, windowed editing frames  Select/Cut/Copy/Paste between editing frames  Etc.

10 The Outline View Outline Just like the rest of the file editing you've done this week, the Outline view synchronizes with your development activity, and can be used effectively  Synchronized selection between the Outline view and editor  You can navigate through the Outline view and:  Select  Cut  Copy  Paste  Delete

11 The MFS Map Editor – Overview Map Editor Toolbar Palette (Tools) Palette (Tools) Viewing modes Viewing modes Design Canvas Row, Column Rulers

12 Source View Mode  Displays your MFS file in source (macro/assembler) mode  Customized color highlighting  Line numbers  Syntax error markers  Field selection is maintained between Design  Source mode Design  Source  Preview  At any time during your MFS work you can flip from Design  Source  Preview mode

13 Source View Mode – Context Menu Options Standard source-level GUI development editing options available:  Save  Cut  Copy  Paste  Shift Right/Left  Snippets  Compare (next slide)  Replace With > (local source history)  Good in-place syntax validation

14 Source View Mode - Compare/Replace With Options  Same functionality as the LPEX editor for source files

15 Preview Mode Preview  Here is an MFS map in Preview mode Toggle Sample Values  Note that we have set Toggle Sample Values "on" in Design mode, for this screen capture  Preview mode is basically for screen documentation, design-reviews and prototyping your 3270-U.I.  There is no application COBOL/CICS Send/Receive logic executing  But you could use Preview mode effectively during U.I. Design/JAD sessions with business users  Most of your work will be done using the Design Mode – so let's return to that, and see what it has to offer MFS developers

16 The MFS Map Editor – Design Mode Map Editor Toolbar  Palette Tools & Widgets Palette Tools & Widgets Design Canvas painting Provides "declarative development" facilities for painting 3270/MFS screens, or doing: Screen maintenance MAP development (from scratch) 

17 MFS Editor – Toolbar Display Options (Part 1 of 2)  Display options enable you to control how MAPs are displayed in the editor at design time.  Size – drop-down list to select a new size for the Map  Toggle Gridlines – shows or hides a grid over the form to help in sizing and arranging fields for input fields  Toggle Sample Values – shows or hides sample values for input fields, which are otherwise invisible unless they have the Initial property specified Note: Note: Feel free to try any/all of these design and display options while reading through these slides

18 MFS Editor – Toolbar Display Options (Part 2 of 2)  Display options enable you to control how MAPs are displayed in the editor at design time.  Toggle Black and White Mode – switches the editor between black and white mode and full color mode using the default background color  Zoom level – sets the magnification level of the editor

19 MFS Editor – Palette View  Select – Allows you to select a field and sets focus on that field  Marquee – Allows you to select multiple fields at once Basic - used to create: -MFS structural elements (DIV/DEV/DPAGE/PPAGE) -Labels  string of text that does not change in a Map. Unlike variable fields, labels cannot be accessed by you COBOL or PL/I code -Input/Output/Password/System Message - serve as input or output data in a Map. Each variable field is based on an COBOL field. Variable fields can be accessed by your COBOL or PL/I code  Advanced – assist you in creating Operator Control Tables  Used to add new MFS elements (Maps and Field elements) to an MFS screen – by dragging and dropping onto the Design Canvas

20 MFS Map Enhancements – Using the Palette  Let's add phone# as a new literal and field to MENU.mfs. To that we'll:  Select and move an existing field down two rows  Add a literal and input field  Selecting and dragging MFS fields – options:  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 arrows – to select (not move, just select) fields in your MFS map Note that you may not have this sample screen in your class examples

21 Using the Palette – Adding New Fields  Add a new Label to the map from the Palette Label  Left-click to select: Label  Holding down the left-mouse button  Drag the mouse pointer to: –Row: –Column:  Drop PHONE:  Type in the label's text: PHONE:  A few things:  You will notice that the widget's color is green.  This can be:  Changed for this one label (next slide)  Changed for all new labels (from MFS Editor Preferences – covered in a bit)  If you make an mistake and drop the field in the wrong place – or you type something else that needs fixing, you will find it easy to modify every element of your MFS field

22 Using the Palette - Customizing Field Properties  The MFS Editor allows you to modify every element of your screen using a consistent Properties dialog  Select the field  Select the Properties view Properties  From Properties you can customize virtual any element of an MFS screen field: Basic  From Basic:  Enter MFS field name –Note that labels are rarely named in MFS maps  Alter the layout R/C  Change field length  Modify initial value The Field Properties dialog is available for new, or existing ( from an imported MFS) map fields

23 Additional Field Properties Basic Properties  Besides Basic there are three additional Properties menus:  Attributes:  Disabling/Enabling data entry  Field visibility/intensity  Adding the Modified Data Tag  Extended Attributes  Highlighting, Color  Different types of boxed outlines  Features  Gives you control over the creation of Operator Control Tables

24 Using the Palette – Add an Input Field  Add a new Input Field to the map - from the Palette  Left-click to select: Input Field  Holding down the left-mouse button  Drag the mouse pointer to: –Row –Column  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  Or – feel free to experiment with your own options for this new field (this is not a production map)

25 Using the Palette – Finished Enhancement  Added – Phone number field with literal label and initial value Source  If you already know the MFS language, consider looking at the Source view to see what has been generated for your new fields  Suggestion Spend a few minutes with the class MFS file to experiment with these and other options from the toolbar/Palette

26 Properties view for your Map’s DEV Macro For other MFS macros, the Properties view will change to reflect whatever is selected

27 The MFS Map Editor – Context Menu – 1 of 2 The context menu has a few additional capabilities when in Design view: Show Source Show Source Select field(s) Select field(s) Alignment options Alignment options  Format options Same as the Properties view 

28 The MFS Map Editor – Context Menu – 2 of 2 Other Context Men options continued: Print Print (to local printer) Show Source Show Source (context sensitive): Of field Of Map Print Show Source

29 UNIT Topics: The RDz Workbench   The RDz MFS Map Editor  Generating Symbolic and Physical Maps  Appendix

30  Generating Your MFS Maps There are a couple of ways of generating the symbolic maps for MFS Maps.  The first option is via JCL generation to run MFS gen  This will create both the copybook, and the physical map in FORMATLIB

31  Generating a copybook from an MFS Map Steps  Select any MFS file,  Right-click and select:  Generate >  Generate copybook The second option - which is valid only for generating COBOL copybooks - is done without actually assembling the MFS macros. - This is valid for both local and remote MFS resources.

32 MFS Property Groups for Generated JCL and Copybook Generation  Relies on an installed RDz PROC  You will need to customize the High-level qualifier for FORMAT library Note two other datasets:  Listing file  SYSLIB SYSKLIB is where a generated COBOL copybook will go

33 MFS Editor Preferences There are minimal MFS Editor preferences Most relate to editor source defaults

34 Summary Having completed this unit, you should be able to:  Describe the function of MFS maps  Describe the components of MFS maps  Use the development features of the MFS map editor  Describe how to open and edit existing MFS maps  Show how to generate MFS maps to copybooks  List the outputs of the generate process