Sei sulla pagina 1di 38

gspubb.

book Page 1 Monday, July 26, 2004 12:24 PM

*HWWLQJ6WDUWHG
Issue 1a, June 2004

0DLQIUDPH([SUHVV
(QWHUSULVH(GLWLRQ
JHWWLQJVWDUWHGZLWK
PDLQIUDPHH[SUHVV
HQWHUSULVHHGLWLRQ

gspubb.book Page 2 Monday, July 26, 2004 12:24 PM

Copyright 2004 Micro Focus International Limited.


All rights reserved.
Micro Focus International Limited has made every effort to ensure that this book is
correct and accurate, but reserves the right to make changes without notice at its sole
discretion at any time. The software described in this document is supplied under a
license and may be used or copied only in accordance with the terms of such license,
and in particular any warranty of fitness of Micro Focus software products for any
particular purpose is expressly excluded and in no event will Micro Focus be liable for
any consequential loss.
Animator, COBOL Workbench, EnterpriseLink, Mainframe Express,
Micro Focus, Net Express, REQL and Revolve are registered trademarks, and
AAI, Analyzer, Application to Application Interface, AddPack, AppTrack,
AssetMiner, CCI, DataConnect, Dialog System, EuroSmart, FixPack,
LEVEL II COBOL, License Management Facility, License Server,
Mainframe Access, Mainframe Manager, Micro Focus COBOL, Object COBOL,
OpenESQL, Personal COBOL, Professional COBOL, Server Express,
SmartFind, SmartFind Plus, SmartFix, SourceConnect, Toolbox, WebSync,
and Xilerator are trademarks of Micro Focus International Limited. All other
trademarks are the property of their respective owners.
No part of this publication, with the exception of the software product user
documentation contained on a CD-ROM, may be copied, photocopied, reproduced,
transmitted, transcribed, or reduced to any electronic medium or machine-readable
form without prior written consent of Micro Focus International Limited.
Licensees may duplicate the software product user documentation contained on a CDROM, but only to the extent necessary to support the users authorized access to the
software under the license agreement. Any reproduction of the documentation,
regardless of whether the documentation is reproduced in whole or in part, must be
accompanied by this copyright statement in its entirety, without modification.
U.S. GOVERNMENT RESTRICTED RIGHTS. It is acknowledged that the Software and the
Documentation were developed at private expense, that no part is in the public
domain, and that the Software and Documentation are Commercial Computer
Software provided with RESTRICTED RIGHTS under Federal Acquisition Regulations
and agency supplements to them. Use, duplication or disclosure by the U.S.
Government is subject to restrictions as set forth in subparagraph (c)(1)(ii) of The
Rights in Technical Data and Computer Software clause at DFAR 252.227-7013 et. seq.
or subparagraphs (c)(1) and (2) of the Commercial Computer Software Restricted
Rights at FAR 52.227-19, as applicable. Contractor is Micro Focus, 9420 Key West
Avenue, Rockville, Maryland 20850. Rights are reserved under copyright laws of the
United States with respect to unpublished portions of the Software.

20040726122421

gspubb.book Page 3 Monday, July 26, 2004 12:24 PM

Table of Contents

About this Book. . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Welcome! . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Functionality . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11
Mainframe Express . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

11

Analysis Option. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

11

AppMaster Builder . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
AppMaster Builder Customizer . . . . . . . . . . . . . . . . . . . . . . . . . .

12
13

Component Generator. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

13

Using Mainframe Express Enterprise Edition . . . . . 15


The Application Maintenance Cycle . . . . . . . . . . . . . . . . . . . . . . . . .
Traditional Maintenance . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
AppMaster Generation Maintenance . . . . . . . . . . . . . . . . . . . . .

15
16
20

Legacy Extension . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Using Component Generator . . . . . . . . . . . . . . . . . . . . . . . . . . .

24
24

New Features . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 29
New Users . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

29

Benefits of Integration. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

29

Mainframe Express Users . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

30

Workbench Users . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

31

AppMaster Builder Users . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

32

APS Users. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

32

EnterpriseLink Component Generator Users . . . . . . . . . . . . . . . . . .

33

Getting Started with Mainframe Express Enterprise Edition

gspubb.book Page 4 Monday, July 26, 2004 12:24 PM

A Send Us Comments . . . . . . . . . . . . . . . . . . . . . . . . . . 35
To Send a Comment. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 35

Getting Started with Mainframe Express Enterprise Edition

gspubb.book Page 5 Monday, July 26, 2004 12:24 PM

About this Book


This book is an overview of Mainframe Express Enterprise Edition. You
should read it before any other Getting Started book included with
Mainframe Express Enterprise Edition.

Getting Started with Mainframe Express Enterprise Edition

gspubb.book Page 6 Monday, July 26, 2004 12:24 PM

About this Book

Getting Started with Mainframe Express Enterprise Edition

gspubb.book Page 7 Monday, July 26, 2004 12:24 PM

1 Welcome!
Welcome to Mainframe Express Enterprise Edition! Micro Focuss
unified environment for mainframe development significantly reduces
risks and costs, and offers improved business agility through extension
to J2EE, .Net and Web Services.

Introduction
Mainframe Express Enterprise Edition accelerates the transformation of
legacy assets through a highly productive integrated environment for
mainframe application development. Hosted on the PC, it includes
capabilities for generation, analysis, compilation, debugging and unit
testing of your applications on workstations. It also enables you to
expose existing business transactions as JavaBeans, Enterprise
JavaBeans, .NET or Web services.
Mainframe Express Enterprise Edition combines and integrates features
available in separate predecessor products (including Mainframe
Express, AppMaster Builder and EnterpriseLink Component Generator)
to provide a complete integrated environment for COBOL application
generation, development, maintenance and extension.
This Getting Started with Mainframe Express Enterprise Edition book
gives an overview of Mainframe Express Enterprise Edition and
describes how to use the combined functionality. In addition, online
Getting Started books are provided for each of the key functional
areas in the product.
We suggest that, after reading this book to get the overall picture, you
then read the Getting Started books for the areas you are interested in.
Each contains an overview followed by basic tutorials.
If a word is shown like this in the online documentation: click, you can
click it to display its glossary entry.

Getting Started with Mainframe Express Enterprise Edition

gspubb.book Page 8 Monday, July 26, 2004 12:24 PM

Chapter 1 Welcome!

Functionality
Mainframe Express Enterprise Edition contains the following key
functional areas:

Mainframe Express
Mainframe Express provides tools enabling you to use your PC to
develop, maintain and test applications for deployment on the
mainframe. It includes integrated tools for editing, compiling and
visually debugging mainframe applications. Mainframe Express also
provides powerful tools such as project-management capabilities
and IBM mainframe emulation.

Analysis Option
The Analysis Option helps you understand the logic of existing
applications so you can maintain them more effectively. It enables
you to analyze application source within Mainframe Express
projects so you can understand the logic. It stores this analysis in a
database, which you can interrogate to help you understand the
application.

AppMaster Builder
AppMaster Builder is an application generator that automates the
development of applications. You paint CICS or IMS screen
interfaces and programs. AppMaster Builder then generates the
BMS or MFS source corresponding to the screen and generates the
COBOL program source. It can also generate batch programs,
including for example Report Writer programs. Generation rules can
be customized to suit your environment and enforce your shop
standards.
AppMaster Builder includes a facility similar to Analysis Option,
enabling you to analyze application source within AppMaster
Builder projects to help you in maintenance.
The AppMaster Builder functionality has evolved from Micro Focuss
stand-alone AppMaster Builder product.

Component Generator
Component Generator provides a fast and effective way to
integrate legacy CICS or IMS applications with modern e-business
systems while leaving the original application unchanged.

Getting Started with Mainframe Express Enterprise Edition

gspubb.book Page 9 Monday, July 26, 2004 12:24 PM

Functionality

Component Generator generates industry-standard components


(.NET, JavaBeans, EJBs, or Web services) that can be deployed on any
standard application server. These components can drive multiple
back-end transactions, and so can represent a complete business
process, supporting the development of service-oriented
architectures.
The Component Generator functionality has evolved from
Micro Focuss stand-alone EnterpriseLink Component Generator
product.

Getting Started with Mainframe Express Enterprise Edition

gspubb.book Page 10 Monday, July 26, 2004 12:24 PM

10

Chapter 1 Welcome!

Getting Started with Mainframe Express Enterprise Edition

gspubb.book Page 11 Monday, July 26, 2004 12:24 PM

11

2 Overview
This chapter describes the key functional areas in Mainframe Express
Enterprise Edition in more detail.

Mainframe Express
Mainframe Express is a GUI environment for developing and
maintaining COBOL applications in the traditional way, by manually
coding the COBOL source. It includes an editor, a compiler and a
debugger, plus emulation environments for Assembler, CICS, IMS, JCL,
and TSO. It is project-based, and all these tools are closely integrated
with one another to make building an application and correcting
errors extremely fast and easy. Among many other tools and facilities,
it can upload and download source or data files, or access them in
place on the mainframe. Thus, it can access source code on the
mainframe to compile it on the PC, and application test runs on the PC
can access data files on the mainframe.
The main user interface of Mainframe Express is the Integrated
Development Environment (IDE). This is a graphical user interface (GUI)
with dropdown menus, multiple windows, popup help, and so on - in
fact all the usual advantages of a GUI.
The emulators enable you to test your applications on Mainframe
Express before deploying them to your production environment.

Analysis Option
The Analysis Option is a feature within the Mainframe Express IDE. It
analyzes a legacy applications structure, the files it uses, how and
where data items and other artifacts are used, and a number of other
details. It provides a variety of tools which you use to see the
Getting Started with Mainframe Express Enterprise Edition

gspubb.book Page 12 Monday, July 26, 2004 12:24 PM

12

Chapter 2 Overview

relationships and dependencies between items in your application.


Analysis Option gives you a valuable insight into the workings of your
application source code, thereby reducing the complexity, cost and risk
of making application changes. It can analyze applications that include
PL/I and Assembler sources as well as COBOL.
The analysis is stored in a database associated with the applications
Mainframe Express project, and optionally is automatically updated in
the background whenever the project is rebuilt. The analysis can also be
used as input to Component Generator to provide it with useful
information about the application.

AppMaster Builder
AppMaster Builder is a GUI environment for generating mainframe
COBOL applications. You paint a character-mode screen interface and,
by selecting options on dialog boxes, specify the program you want to
support it. You can specify the user interface and database engine you
want. AppMaster Builder then automatically generates the equivalent
COBOL application and associated screens you have designed. This
generated application is 100% standard COBOL and can be compiled by
Mainframe Express.
AppMaster Builder can also generate batch programs, including for
example Report Writer programs.
AppMaster Builder uses customizable rules. You can modify these rules
to tailor the code that is generated in your application, so you can tailor
the generation process to build precisely the applications you want.
Generation rules can be used to enforce your shop standards.
Applications developed using Micro Focuss APS for MVS product can be
imported into AppMaster Builder for further development and
maintenance.
AppMaster Builder includes a facility similar to the Analysis Option, but
working on AppMaster Builder sources (screens, programs, rules, etc),
thus providing AppMaster Builder programmers with valuable help in
maintenance.

Getting Started with Mainframe Express Enterprise Edition

gspubb.book Page 13 Monday, July 26, 2004 12:24 PM

Component Generator

You can test your applications in Mainframe Express before deploying


them. You can use the Mainframe Express debugger to debug S-COBOL.

AppMaster Builder Customizer


The Customizer is a feature within AppMaster Builder. It enables you to
call user-defined and pre-defined rules into COBOL programs. You
define rules using the Micro Focus Generator (MFG) built-in structures,
native COBOL, S-COBOL (a type of short-hand COBOL), or any
combination of the three. AMB also provides many pre-defined
Customizer rules.
When coding a program, you call a user rule using specific MFG syntax.
When AMB generates your program, Customizer rules called from the
program are expanded into native COBOL.
The use of Customizer rules offers several advantages over coding
native COBOL directly:

Flexibility - Customizer rules can be coded into programs created


with the Program Painter, as part of an Online Express specification,
or in any text editor

Expandability - Rules require relatively little code, which expands


into larger volumes of native COBOL when processed by the Micro
Focus Generator

Consistency - each rule, when expanded, provides consistent COBOL


code

Reusability - you can call a rule any number of times from any
number of programs

Availability - both pre-defined and user-defined rules can be made


available to all AMB developers in your shop

Component Generator
Component Generator is a feature within the Mainframe Express IDE. It
is a GUI environment enabling developers to expose legacy application

Getting Started with Mainframe Express Enterprise Edition

13

gspubb.book Page 14 Monday, July 26, 2004 12:24 PM

14

Chapter 2 Overview

workflows as component-based services. Component Generator


automatically generates all the source code required to integrate legacy
applications with other e-business systems, including the component
(.NET, JavaBeans component, EJB, or Web service), its supporting COBOL
driver module and the appropriate middleware protocol.
The combination of the generated component and supporting COBOL
module is referred to as an eBiz transaction.
Because all the required pieces are generated, you do not need
specialized training or expertise in C#, Java or middleware coding. No
changes are required to the existing application.
The auto-deployment feature means you can deploy to certain
application servers with a simple click of a button. You can also publish
details of a Web service to a UDDI repository with a simple click of a
button.
Component Generator can use the analysis of an application by the
Analysis Option as a starting point for creating eBiz transactions. If an
application was developed using AppMaster Builder, you run the
Analysis Option in Mainframe Express on the generated sources, and
this analysis is used.
You can test your eBiz transactions on Mainframe Express before
deploying them.
Note: If Micro Focuss Revolve product is on your machine, a function to
run it appears automatically on your Mainframe Express menu. This is
provided for compatibility reasons. Users of Mainframe Express
Enterprise Edition should not normally use this function.

Getting Started with Mainframe Express Enterprise Edition

gspubb.book Page 15 Monday, July 26, 2004 12:24 PM

15

3 Using Mainframe Express


Enterprise Edition
Mainframe Express Enterprise Edition can be used in many ways, but its
greatest strength is in offloading the maintenance and enhancement
of mainframe applications. This chapter describes some of the most
common scenarios.

The Application Maintenance Cycle


The usual process of updating a mainframe application using
Mainframe Express Enterprise Edition is, in brief:
1

Download the sources to the PC, or connect to them on the


mainframe

Understand the application

Update the source

Compile the source and build the application

Debug the changes

Test the application

Upload the sources to the mainframe if you downloaded them.

Compile and system test on the mainframe

You can return from any step to any earlier step to correct errors hence the term "cycle".
Note: Of course, you can use Mainframe Express Enterprise Edition to
develop new applications, and to develop and maintain PC
applications. These processes are subsets of the process of maintaining
a mainframe application - for example, there is no need to download

Getting Started with Mainframe Express Enterprise Edition

gspubb.book Page 16 Monday, July 26, 2004 12:24 PM

16

Chapter 3 Using Mainframe Express Enterprise Edition

or import existing sources. Therefore, we will concentrate on describing


how you use Mainframe Express Enterprise Edition for offloading - that
is, using the PC to maintain or enhance your existing mainframe
applications.

If your mainframe applications were developed using Micro Focuss APS


product, your sources are in the form of APS screens, programs, rules
and so on. Alternatively, if your applications were created by coding
directly in COBOL, your sources consist of COBOL programs and perhaps
CICS BMS screens or IMS MFS screens. Well refer to these two methods
as application generation and traditional. Mainframe Express Enterprise
Edition can be used to maintain both types of application with equal
ease.
Alternatively, you might already have been using Micro Focus products
to develop mainframe applications on the PC, using Workbench for
traditional development or the stand-alone AppMaster Builder product
for application generation development. In this case, your sources are
already on the PC. You can easily migrate them from Workbench or the
stand-alone AppMaster Builder to Mainframe Express Enterprise Edition
for future maintenance.
The following two subsections describe the maintenance of a
traditionally-developed application and of an application developed by
application generation. As well as the features described already, these
subsections introduce some of the many other tools provided to assist in
maintenance, such as the source-level debugger, the Test Coverage
facility, Mainframe Access, and the AppMaster Builder Migration
Wizard.

Traditional Maintenance
Maintaining a traditional COBOL application using Mainframe Express
Enterprise Edition consists of the following steps (also shown
diagrammatically, in Figure 3-1 below):
1

Use Mainframe Access (MFA) Drag & Drop to download the sources
from the mainframe to the PC.
Your administrator might do this step for you.

Getting Started with Mainframe Express Enterprise Edition

gspubb.book Page 17 Monday, July 26, 2004 12:24 PM

The Application Maintenance Cycle

Mainframe Access is Micro Focuss host connectivity software,


included as part of Mainframe Express Enterprise Edition. Drag &
Drop is a file transfer facility within Mainframe Access. You need to
have installed Mainframe Access server on your mainframe. This
runs as a z/OS started task.
We recommend that you download your sources when you first
migrate the application to Mainframe Express Enterprise Edition,
and thereafter keep your master sources on the PC, so this
download is a once-only task. Alternatively, you can keep the
sources on the mainframe and have the tools in Mainframe Express
Enterprise Edition access them there - the SourceConnect facility in
Mainframe Access enables you to see the mainframe as if it were a
drive on the network, so you can edit, compile, and debug at the PC
without moving the sources to the PC. This may be more convenient
in some circumstances, but inevitably performance will be better if
you access them locally on the PC.
You can store your sources in a Source Code Manager (SCM) if you
want. Some SCMs can be integrated with Mainframe Express, so
that you can check files in and out from the Mainframe Express
menus, or have files automatically checked out when you open
them for edit. This is the case even if the SCM is on the mainframe.
Test data too can be downloaded, or alternatively left on the
mainframe for the application to access from the PC via the
DataConnect facility in Mainframe Access.
2

Create a Mainframe Express project for your application.


A project is a file containing links to, and details of, all the files in
your application. You view it as a tree view in a project window
within the IDE. This tree view shows all the details of your
application, and you do all your work in the project window.

Use the Analysis Option to analyze the source to discover the uses of
and relationships between elements in your application.
A major problem in maintaining an existing application is
understanding logic written by someone else, often many years
ago. The Analysis Option analyzes the source, identifying where
items are used and referenced and the impact of changing them,
and identifying self-contained procedures. This is a major aid in
debugging and maintenance. The analysis is stored in a database
associated with the Mainframe Express project.

Getting Started with Mainframe Express Enterprise Edition

17

gspubb.book Page 18 Monday, July 26, 2004 12:24 PM

18

Chapter 3 Using Mainframe Express Enterprise Edition

Update the COBOL source, using the COBOL editor in Mainframe


Express.
The editor displays different types of COBOL words (for example,
verbs, data-names, etc.), in different colors, so that many types of
error are obvious to you immediately, without even waiting for
compilation.
The first time through after migrating the application, you will
probably want to omit this step and go straight to compiling and
running the application, to ensure the migrated application works
before you start updating it.

Compile the source (build the application).


Compilation error messages are displayed in the IDE, and if you click
on one the editor appears, positioned at the line in error. Pressing
F1 brings up help about the error.
Optionally, the application analysis done by Analysis Option is
automatically updated.

Debug the application, using the extensive single-stepping and data


monitoring facilities in the source-level debugger.
You can move swiftly and directly between the debugger, editor,
and compiler to fix errors. The debugger works not only in the
normal Mainframe Express environment, but also with the
emulators included in Mainframe Express.

Use the Test Coverage facility to check that every path through the
application is covered by your tests.
The Test Coverage facility produces reports showing how many
times each line and block of code has been executed. If after
running the application with all your different sets of data some
lines are still shown as never executed, you have identified a gap in
your testing.

Test the application on the PC, in one of the emulators in


Mainframe Express.
Mainframe Express includes CICS, IMS, JCL and TSO emulators.

For final system test and production, deploy the built application to
your production environment.

Getting Started with Mainframe Express Enterprise Edition

gspubb.book Page 19 Monday, July 26, 2004 12:24 PM

The Application Maintenance Cycle

For example, upload the files to your mainframe and deploy them
in a CICS or IMS region.
This process is shown diagrammatically in Figure 3-1.
Figure 3-1. The Maintenance Process for a Traditional COBOL
Application

Getting Started with Mainframe Express Enterprise Edition

19

gspubb.book Page 20 Monday, July 26, 2004 12:24 PM

20

Chapter 3 Using Mainframe Express Enterprise Edition

AppMaster Generation Maintenance


AppMaster Builder contains its own Analysis Option, which does a
similar job to the one in Mainframe Express, but on AppMaster Builder
sources and with a subset of the features. It enables you to determine
relationships between the entities (programs, screens, data structures,
user rules, and so on) at the AppMaster Builder application level or at
the AppMaster Builder project level.
AppMaster Builder also contains a Migration Wizard, which you use to
download APS sources from the mainframe and import them into an
AppMaster Builder project.
Maintaining a COBOL application developed by application generation,
using Mainframe Express Enterprise Edition, consists of the following
steps (also shown diagrammatically, in Figure 3-2 below):
1

Use the Migration Wizard to download the sources from the


mainframe to the PC and import them into an AppMaster Builder
project.
Your administrator might do this step for you.
The Migration Wizard uses the Mainframe Access (MFA) Compare
and Synchronization monitor to connect to the mainframe and
import the sources. Mainframe Access is Micro Focuss host
connectivity software, included as part of Mainframe Express
Enterprise Edition. The Mainframe Access server must be installed
on your mainframe. This runs as a z/OS started task.
We recommend that you download your sources when you first
migrate the application to Mainframe Express Enterprise Edition,
and thereafter keep your master sources on the PC, so this
download is a once-only task. Everything necessary to get your
sources into a suitable directory structure on the PC is done by the
Wizard.
You can store your sources in a Source Code Manager (SCM) if you
wish. Some SCMs can be integrated with AppMaster Builder, so that
you can check files in and out from the AppMaster Builder menus.
Test data too can be downloaded, or alternatively left on the
mainframe for the application to access from the PC via the
DataConnect facility in Mainframe Access.

Getting Started with Mainframe Express Enterprise Edition

gspubb.book Page 21 Monday, July 26, 2004 12:24 PM

The Application Maintenance Cycle

Create an AppMaster Builder project for your application.


A project is a folder structure containing the related entities that
make up your application. You view it as a tree view in a project
window within the IDE. This tree view shows all the details of your
application, and you do all your work in the project window.

Use the AppMaster Builders own Analysis Option to analyze the


source to discover the uses of and relationships between elements
in your application.
A major problem in maintaining an existing application is
understanding logic written by someone else, often many years
ago. The analysis facilities analyze the source, identifying where
items are defined and referenced and the impact of changing them.
The analysis is stored in a database associated with the AppMaster
Builder project.

Update the source - screens, program, S-COBOL and so on - using


AppMaster Builder.
The first time through after migrating the application, you will
probably want to omit this step and go straight to compiling and
running the application, to ensure the migrated application works
before you start updating it.
You use the tools within AppMaster Builder as follows:

Use the Application Properties dialog box to update your


interface and database target.

Use the screen painter to update your screens.

Use the Program Painter to update your program.

Use Online Express to update relationships between actions


(such as pressing a key) and events (such as querying a database
or performing other business logic), associate screen fields with
database columns, and create/modify interactions with your
database.

Customize the processing (if necessary) by writing scripts in SCOBOL, a COBOL-based scripting language.

In AppMaster Builder, use the Application Properties dialog box to


associate the application with a Mainframe Express project.

Getting Started with Mainframe Express Enterprise Edition

21

gspubb.book Page 22 Monday, July 26, 2004 12:24 PM

22

Chapter 3 Using Mainframe Express Enterprise Edition

AppMaster Builder generates the application for you, and calls the
Mainframe Express compiler to compile it.

Debug the application, using the extensive single-stepping and data


monitoring facilities in the source-level debugger.
The source-level debugger can debug either S-COBOL or native
COBOL, and can even show both side by side. It works not only in
the normal Mainframe Express environment, but also with the
emulators included in Mainframe Express.
If you find changes are needed to the application, you should
update the sources in AppMaster Builder. We do not recommend
that you edit the generated COBOL directly using the Mainframe
Express editor, as any changes you make will be lost when you next
regenerate. However, you might find it useful to view your S-COBOL
in the editor, since the editor recognizes and colorizes S-COBOL
syntax - this means many types of error are obvious to you
immediately, without waiting for compilation.

Use the Test Coverage facility to check that every path through the
application is covered by your tests.
The Test Coverage facility produces reports showing how many
times each line and block of code has been executed. If, after
running the application with all your different sets of data, some
lines are still shown as never executed, you have identified a gap in
your testing.
Test Coverage works with generated COBOL source, not S-COBOL.

Test the application on the PC, in one of the emulators in


Mainframe Express.
Mainframe Express includes CICS, IMS, JCL and TSO emulators.

10 For final system test and production, deploy the built application to
your production environment.
For example, upload the files to your mainframe and deploy them
in a CICS or IMS region.
This process is shown diagrammatically in Figure 3-2.

Getting Started with Mainframe Express Enterprise Edition

gspubb.book Page 23 Monday, July 26, 2004 12:24 PM

The Application Maintenance Cycle

Figure 3-2. The Maintenance Process for an "Application Generated"


Application

Getting Started with Mainframe Express Enterprise Edition

23

gspubb.book Page 24 Monday, July 26, 2004 12:24 PM

24

Chapter 3 Using Mainframe Express Enterprise Edition

Legacy Extension
Legacy extension means extending and enhancing the usefulness of a
legacy application. This often involves adding a new, more modern
interface or integrating the application into a new enterprise-wide or
business-to-business system. For example, if the application has a CICS
or IMS character-based interface, you might want to add a graphical
Web interface for use by staff, business partners or customers.
A software component, also called a reusable object, is a unit of
executable code with an explicit set of interfaces. It is written
independently of any applications that might use it, and is deployed as
a service, available to be invoked by any client application. There are
many mechanisms that make this possible - see the section Component
Generator in the earlier chapter Overview.
Component Generator creates an interface to a legacy application, so
that it appears to the outside world as an industry-standard component,
which provides a set of methods available for invocation by remote
clients. In this way, your proven business processes can be accessed from
virtually any modern technology. This interface can be invoked by a
new Web front end or another component-based application.

Using Component Generator


In Component Generator, you create a set of eBiz transactions, which
represent business processes. An eBiz Transaction consists of the
generated component plus a supporting COBOL module that resides on
the mainframe and drives one or more CICS or IMS transactions. To
define the eBiz transactions, you can do one or more of the following:

Use the Analysis Option in Mainframe Express to analyze the


application. Component Generator uses the analysis to identify the
sequence of transactions and steps required to complete a specific
business process. (If the application was developed by application
generation, you run the Analysis Option on the generated source.)

Run the legacy application in a special terminal emulator called the


Workflow Capture Facility. This records the sequence of transactions
and steps required to complete a specific business process. (For IMS,

Getting Started with Mainframe Express Enterprise Edition

gspubb.book Page 25 Monday, July 26, 2004 12:24 PM

Legacy Extension

you must run the Analysis Option first; for CICS, you can use
Workflow Capture with or without the Analysis Option.)

Use Component Generator to analyze the COMMAREA(s) of one or


more programs, to define a component that interfaces with their
communication areas rather than with a 3270 screen interface (CICS
only).

Use Component Generator to generate "data access" components


that provide direct access to data in mainframe DB2, VSAM or IMS
databases. These components bypass the legacy application
altogether, minimizing the mainframe resources required to obtain
raw data.

Your application continues running unchanged - adding this


component interface does not interfere with the normal operation of
the application.
A typical process for legacy extension, combining the first two of the
above methods, consists of the following steps (also shown
diagrammatically, in Figure 3-3 below):
1

If the application was developed by application generation,


generate COBOL source.

In Mainframe Express, use the Analysis Option to analyze the


COBOL source.
Note that you use the Analysis Option in Mainframe Express for this,
even for an application developed by application generation.

Run the legacy application in the Workflow Capture Facility.


This records the sequence of transactions and steps required to
complete a specific business process.

In Component Generator, define a set of eBiz transactions based on


the workflows and analysis obtained above:
a

Use the eBiz Transaction Wizard to create the eBiz transactions

Use the eBiz Transaction Painter to complete the eBiz


transactions

In Component Generator, generate the component.


This also generates a supporting COBOL driver module and test
clients.

Getting Started with Mainframe Express Enterprise Edition

25

gspubb.book Page 26 Monday, July 26, 2004 12:24 PM

26

Chapter 3 Using Mainframe Express Enterprise Edition

Component Generator also generates client applications that can be


used for testing and as templates for production clients. For Java,
Component Generator generates Java application or JSP test clients.
For .NET, Component Generator generates C# or ASPX test clients.
6

Deploy the component.


Typically, the generated component is deployed to a mid-tier
application server running on a PC or a cluster of PCs. The server
software you choose depends on the type of component you
generate - for example, when using EJBs you would use a Java
application server, such as IBMs WebSphere Application Server. The
auto-deployment feature of Component Generator enables you to
the component and the test client to the application server by a
simple click of a button.

Deploy the COBOL module to the mainframe or Mainframe Express


for testing.

Use the generated test clients to test the deployed component and
COBOL module.
At run time, the client invokes the generated component, which
then interfaces with the generated COBOL module. The generated
COBOL module drives one or more existing CICS or IMS transactions
to complete a business process.

For final system test and production, deploy the COBOL module to
your production environment.

Your application itself can be running all the time you are doing this you don't need to stop it, change it or redeploy it in any way; adding
this component front-end does not interfere at all with the application
itself.
If you have generated a Web service, you need to publish your service to
a UDDI repository. The auto-publish feature of Component Generator
allows you to push-button publish your service to any UDDI repository.
The above typical process is shown diagrammatically in Figure 3-3. The
dotted arrows show the calls made at run time from the test client to
the component, from the component to the COBOL module, and from
the COBOL module to the legacy application.

Getting Started with Mainframe Express Enterprise Edition

gspubb.book Page 27 Monday, July 26, 2004 12:24 PM

Legacy Extension

Figure 3-3. Legacy Extension Using Component Generator

Getting Started with Mainframe Express Enterprise Edition

27

gspubb.book Page 28 Monday, July 26, 2004 12:24 PM

28

Chapter 3 Using Mainframe Express Enterprise Edition

Getting Started with Mainframe Express Enterprise Edition

gspubb.book Page 29 Monday, July 26, 2004 12:24 PM

29

4 New Features
This chapter lists features that will be new to you depending on which
Micro Focus products you have used before.

New Users
If youre entirely new to Mainframe Express Enterprise Edition and its
predecessors, youll find its great advantage is that you can do all your
development and maintenance work, including all but the final live
stages of testing, on the PC. This means you free your mainframe to
concentrate on production.
In addition, you will find all the advantages described in the sections
below.

Benefits of Integration
If youve been using Mainframe Express, AppMaster Builder, or
Component Generator until now, youll find that having all their
features integrated into one product brings many benefits. For
example:

You can now use AppMaster Builder to generate an application,


and then use the source-level debugger to debug it (both COBOL
and S-COBOL), the Analysis Option to examine its structure, and
the Test Coverage feature to check you are testing it thoroughly.

You can import source loaded in Mainframe Express (which might


have been generated by AppMaster Builder), into Component
Generator, so that you can deploy your application as a reusable
component.

Getting Started with Mainframe Express Enterprise Edition

gspubb.book Page 30 Monday, July 26, 2004 12:24 PM

30

Chapter 4 New Features

All the working information that underlies the development of an


application, such as its project file, the analysis database produced by
the Analysis Option, any workflows captured by Component Generator,
and so on, are seamlessly available to all the different facilities within
Mainframe Express Enterprise Edition.

Mainframe Express Users


Here is an overview of some of the major enhancements in Mainframe
Express 3.0 compared with Mainframe Express 2.5:

New dialect setting to provide compatibility with Enterprise COBOL


for z/OS.

Support for IBM DB2 up to version 7

Added support for CICS TS 2.2 and IMS 8

Analysis Option

Test Coverage Reporting

ISPF-like functions in source editor

SQL Assistant for faster production of embedded SQL statements in


COBOL

Improved data file editor

Automatic FixPack installation utility

Improved source synchronization and build automation

Usage logging

Improved tools for downloading mainframe data and transaction


information

Improved build exit points for better integration with 3rd party
products and in-house processes

Getting Started with Mainframe Express Enterprise Edition

gspubb.book Page 31 Monday, July 26, 2004 12:24 PM

Workbench Users

Workbench Users
Within Mainframe Express Enterprise Edition, support for traditional
development and maintenance of mainframe applications is provided
by Mainframe Express. The above section Mainframe Express Users
describes the enhancements in Mainframe Express 3.0, compared with
Mainframe Express 2.5.
You will furthermore find that Mainframe Express provides a much
improved development and maintenance environment when compared
to Micro Focus COBOL Workbench 4.0. Some of the highlights are listed
below:

Modern, Windows-based Integrated Development Environment


(IDE) providing access to all necessary tools.

Easier and faster setup.

Server based install option for easier management.

Higher compatibility with mainframe compiler options

Intelligent "build" of an entire application with one click of the


mouse.

Improved editing and debugging functionality for higher


productivity.

Integration with common Configuration Management tools such as


CA-Endevor, CA-Librarian, MERANT PVCS and Microsoft Visual
Sourcesafe.

Includes all emulators necessary for mainframe system


development: CICS, IMS, JCL, TSO, REXX, Assembler, SQL Option for
DB2.

Direct connection to mainframe to access source and data

Synchronization facilities to keep in step with mainframe libraries.

Workgrouping features to provide a multi-user framework,


allowing you to share essential resources such as sources, data and
load libraries.

Mainframe-style catalog with mainframe naming conventions.

Getting Started with Mainframe Express Enterprise Edition

31

gspubb.book Page 32 Monday, July 26, 2004 12:24 PM

32

Chapter 4 New Features

Simple "Drag and Drop" downloads of mainframe source and data


into your Mainframe Express environment.

AppMaster Builder Users


Here is an overview of some of the major enhancements in the
AppMaster Builder in Mainframe Express Enterprise Edition compared
with the stand-alone AppMaster Builder 4.0 product:

Analysis Option for AppMaster Builder sources

Additional COBOL debug window view for debugging S-COBOL

COBOL slaved view in debugger - you can see the generated COBOL
while debugging S-COBOL

Workgrouping, providing improved generation with additional


subsystem support, enabling source residing on the mainframe to
be used during application generation

Generation of XML schema project information

Automated generation/compilation

Usage logging

Support for DB2 version 7.

Note: The AppMaster Builder in Mainframe Express Enterprise Edition


creates and maintains character-based applications. The facility in
AppMaster Builder 4.0 to create GUI applications is not included.

APS Users
Within Mainframe Express Enterprise Edition, support for application
generation of mainframe applications is provided by AppMaster
Builder. The above section AppMaster Builder Users describes the

Getting Started with Mainframe Express Enterprise Edition

gspubb.book Page 33 Monday, July 26, 2004 12:24 PM

EnterpriseLink Component Generator Users

enhancements in the AppMaster Builder in Mainframe Express


Enterprise Edition, compared with the separate AppMaster 4.0 product.
You will furthermore find that AppMaster Builder provides a much
improved development and maintenance environment when compared
to Micro Focus APS 5.0. Some of the highlights are listed below:

AppMaster Builder runs on the PC, providing the same functionality


on the PC as APS does on the mainframe.
By developing on the PC for deployment on the mainframe, you
avoid using mainframe resources for development. Instead of
cumbersome and expensive mainframe tools, you can take
advantage of the Mainframe Express Enterprise Edition
environment. This is a faster, functionally richer, lower cost way of
producing robust mainframe applications.

Modern, Windows-based Integrated Development Environment


(IDE) providing access to all necessary tools.

From within AppMaster Builder, you can invoke the Migration


Wizard to transfer your APS project group datasets to the PC so you
can maintain them in AppMaster Builder.
The Wizard uses the Mainframe Access (MFA) Synchronization
Monitor to put them in the correct directory structure on the PC.

EnterpriseLink Component Generator Users


Here is an overview of some of the major changes in the Component
Generator in Mainframe Express Enterprise Edition compared with the
stand-alone EnterpriseLink Component Generator 5.0 product:

You can extend both CICS and IMS transactions as reusable


components.

You can generate .NET components for easy integration within the
Microsoft .NET environment.

Usage logging.

Getting Started with Mainframe Express Enterprise Edition

33

gspubb.book Page 34 Monday, July 26, 2004 12:24 PM

34

Chapter 4 New Features

Getting Started with Mainframe Express Enterprise Edition

gspubb.book Page 35 Monday, July 26, 2004 12:24 PM

35

A Send Us Comments
Comments on the books? In the online version of this book, click the
link below.
Please include an indication of exactly where in the books the problem
is - give the book, chapter, and section name.
After clicking the link, you can click this windows Back button to get
back to where you were, so you can see it while youre typing your
comment.
We cannot guarantee to answer every comment, but every comment
will be read and taken note of for future revisions.

To Send a Comment
To email us a comment, click here in the online version of this book:

Note: Your comments will go only to this products Documentation


Team, and not to other units in Micro Focus. This feature is intended
for quick, informal comments regarding the books, and does not
replace the normal facilities for contacting Support or reporting
problems.

Getting Started with Mainframe Express Enterprise Edition

gspubb.book Page 36 Monday, July 26, 2004 12:24 PM

36

Appendix A Send Us Comments

Getting Started with Mainframe Express Enterprise Edition

gspubb.book Page 37 Monday, July 26, 2004 12:24 PM

37

Index

Analysis Option
description 11
purpose 8
AppMaster Builder
description 12
maintenance 20
purpose 8
AppMaster Builder maintenance 20

Introduction
to Mainframe Express Enterprise Edition
7

L
Legacy extension 24

C
Comment
send to Micro Focus 35
Component Generator 24
description 13
purpose 8

M
Mainframe Express
description 11
maintenance 16
purpose 8
Maintenance
AppMaster Builder 20
traditional 16
Maintenance process 15

eBiz transaction 24

N
F
Feedback
send to Micro Focus 35

New features
benefits of integration 29
compared to AppMaster Builder 4.0 32
compared to APS 32

Getting Started with Mainframe Express Enterprise Edition

gspubb.book Page 38 Monday, July 26, 2004 12:24 PM

38

compared to Component Generator 5.0


33
compared to Mainframe Express 2.5 30
compared to Workbench 4.0 31
for new users 29

O
Overview
Mainframe Express Enterprise Edition 11
of Mainframe Express Enterprise Edition
7

P
Process
Mainframe Express Enterprise Edition 15

T
Traditional maintenance 16
Tutorials
capturing a workflow 29

W
Workflow
tutorial on capturing 29
Workflow Capture
tutorial 29

Getting Started with Mainframe Express Enterprise Edition