VisualAge Generator to Enterprise Generation Language Migration Guide


Contents

  • Preface
  • Who should read this book
  • Related information

  • 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 ]