VisualAge Generator to Enterprise Generation Language Migration Guide
Part 1. Migration overview
Chapter 1. Migration Overview
What is new in EGL that requires migration?
Planning your migration
Determining whether you can migrate to EGL
VisualAge Generator features not available in EGL
Terminology differences
Chapter 2. Migration Tool Philosophy
Overview of the VisualAge Generator to EGL Migration Tools
Migration tool terminology
Stage 1 Details
Stage 2 Details
Stage 3 Details
Overview of Single File Migration
Migration challenges
Precise EGL Syntax
When and how part names are resolved
Common code scenarios
Techniques used by the VisualAge Generator to EGL Migration Tool
Known restrictions for the migration tools
General
Stage 1 on Java and Smalltalk
Stages 2 and 3 on WebSphere Studio
Syntax migration
Chapter 3. Handling ambiguous situations
Handling ambiguous situations for data items
Pack data items with even length
Shared edits and messages
Map item edit routine for shared data items
Fill characters for shared data items
Handling ambiguous situations for records
Redefined records
Level 77 items in records
Alternate specification records
Different definitions with the same record name
Handling ambiguous situations for tables
Reserved words and table names
Handling ambiguous situations for map groups and maps
Reserved words and formGroup names
Map group and formGroup requirements
Floating areas and starting positions
Map groups, maps, and device sizes
Map names and help map names
Numeric variable fields
Variable map fields and edit routines
Map fields and the numeric hardware attribute
Map arrays and attributes
Unnamed variable fields
Unprotected map constants
Fields at row=0, column=0
Handling ambiguous situations for programs
Program names and reserved words
Implicit data items in programs
Associated program parts
Intermediate variables required for migration
Handling ambiguous situations for functions, including I/O statements
DISPLAY statement for maps
I/O error routine
SQL I/O statements
SQL I/O and missing required SQL clauses
SQL I/O and !itemColumnName
SQL I/O with multiple updates
Handling ambiguous situations for other statements
Implicit data items in statements
Level 77 items in statements
Assignment statements
FIND statement
RETR statement
SET map PAGE statement
SET mapItem attributes
Checking for IN literal or scalar
Checking SQL and map items for NULL
I/O error values UNQ and DUP
I/O error value LOK
XFER
Handling ambiguous situations for EZE words
EZESYS
EZEWAIT
Part 2. Migrating from VisualAge Generator 4.5 on Java to EGL
Chapter 4. Stage 1 -- Extracting from Java
Installing the Stage 1 migration tool on VisualAge for Java
Adding the migration feature
Setting Stage 1 preferences
Build Plans page
Mapping page
Renaming page
Execution page
Sample MigPreferences.xml file
Before you run the Stage 1 tool -- hints and tips
Improving performance
Saving your workspace
Running the Stage 1 tool
Migration plans and high-level PLP projects
Creating a high-level PLP project
Creating a migration plan file manually
Part 3. Migrating from VisualAge Generator 4.5 on Smalltalk to EGL
Chapter 5. Stage 1 -- Extracting from Smalltalk
Installing the Stage 1 migration tool on VisualAge Smalltalk
Loading the migration feature
Creating the migration database
Setting Stage 1 preferences
Build Plans page
Mapping page
Renaming page
Execution page
Sample MigPreferences.xml file
Deriving file names from your preferences
Before you run the Stage 1 tool -- hints and tips
Improving performance
Saving your image
Running the Stage 1 migration tool
Migration plans and high-level configuration maps
Creating a high-level configuration map
Creating a migration plan file manually
Part 4. Stages 2 and 3-- common to Java and Smalltalk migration
Chapter 6. Stage 2--Conversion to EGL syntax
Setting your workbench preferences
Start up parameters
Required EGL preferences
Recommended preferences
VAGen Migration Syntax Preferences
Other recommended settings
Setting up the Stage 2 VAGen migration file
Running Stage 2
Running Stage 2 from the user interface
Running Stage 2 in batch mode
Chapter 7. Stage 3 -- Import
Running the Stage 3 tool
Running Stage 3 in batch mode
Using the migration sets written to temporary directories
Chapter 8. Running migration in single file mode
Running single file migration using the user interface
Running single file migration using batch mode
Part 5. Completing the migration
Chapter 9. Completing your migration
Saving a baseline for EGL projects and packages
Preliminary steps for completing single file migration
Common steps for both Stage 1 -- 3 and single file migration
Reviewing your EGL source code
Reviewing your EGL build descriptor parts
Reviewing your EGL linkage option parts
Reviewing your EGL resource association parts
Preparing for debugging
Generating and testing with COBOL generation
Generating and testing with Java generation
Part 6. Language and runtime differences
Chapter 10. Language and runtime differences
Language differences
Runtime differences
General differences
Differences in debug
Differences in generated COBOL
Differences in generated Java
Differences between distributed CICS and native workstation environments
Differences between generated C++ and generated Java
Part 7. Appendixes
Appendix A. Reserved words
EGL reserved words
SQL reserved words
SQL reserved words requiring special treatment
Java reserved words
Appendix B. Relationship of VisualAge Generator and EGL Language Elements
General syntax conventions
Data items
Records
Tables
Map groups
Maps
Programs
Functions
Statements
EZE words
Program flow EZE words
SQL EZE words
Date and time EZE words
Other data EZE words
General function EZE words
String EZE words
Math EZE words
User interface EZE words
EZE Java words
Object scripting EZE words
DL/I EZE words
Service Routines
PSBs
Control parts
Generation options part
Linkage table parts
Resource association part
Link edit part
Bind control part
Symbolic parameters
Appendix C. Messages from the migration tools
Messages from the VisualAge Generator to EGL migration tool--Stage 1
Stage 1 common messages
Stage 1 on VisualAge for Java
Stage 1 on VisualAge Smalltalk
Messages from the VisualAge Generator to EGL migration tool-- Stage 2
Messages from the EGL into WebSphere Studio migration tool--Stage 3
Appendix D. Messages on Tasks list or from the preprocessor
Appendix E. IWN.xxx messages on the Tasks list
Appendix F. Situations where incorrect External Source Format causes problems in creation of EGL
Appendix G. Migration Database
Creating the DB2 migration database
Setting the JDBC level for DB2 7.2
Setting the JDBC level for DB2 8.1 or higher
Using DB2 on Windows XP
Creating the migration database
Resetting the migration database
Useful Queries
Notices
Trademarks
Index
[ Top of Page | Previous Page | Next Page | Table of Contents | Index ]
(C) Copyright IBM Corporation 1992, 2005. All Rights Reserved.