VisualAge Generator to Enterprise Generation Language Migration Guide


Running the Stage 1 tool

After you have finished editing your preferences, you are ready to run the Stage 1 migration tool to extract your source code from the Java repository. To do this, perform the following steps:

  1. Navigate to the IBM VisualAge Generator EGL Migration project.
  2. Expand the migration project and then expand the package com.ibm.vgj.mig.
  3. Within the package, select the VAGenToEGLMigration class.
  4. Right-click on the VAGenToEGLMigration class and then click Properties from the context menu.
  5. Select the Program tab.
  6. On the Program page, specify the following in the Command line arguments field to point the MigPreferences.xml file you want to edit:

    Figure 54. Valid command line options for VAGentoEGLMigration class

    Option Meaning of option
    --h Display help information that shows the valid options
    --p filename Use "filename" as the name of the preferences file. You must fully qualify the file name, including the drive and directory.
    --o Overwrite the migration files if they exist and recreate them.
  7. If this is the first time you are running the Stage 1 tool, do the following:
    1. In the same Properties window, select the Class Path tab.
    2. On the Class Path page, select the Extra directories checkbox and then click on the Edit button for the Extra directories.
    3. Select the Add Jar/Zip button.
    4. In the File selection window, navigate to and select the db2java.zip file.
      • If you used the default install directory when you installed DB2, the file should be in the \SQLLIB\java directory.

      After you select the db2java.zip file, the file name appears in the Extra directories window. Click OK on the Extra Directories window.

    5. On the Class Path page, click the Compute Now button and then click Yes at the prompt.
  8. Click on OK to save the properties.
  9. Right-click on the VAGenToEGLMigration and then click Run or Run main... (Or you can pick the running man icon from the tool bar.) The Stage 1 migration tool starts and opens a Console window where it reports progress and any error messages. The migration tool also writes the messages to the log file you specified in your migration preferences.

When the Stage 1 migration tool finishes, if you selected the update database preference, then your migration plan information, including your VAGen code in External Source Format, is stored in the migration database. After reviewing your report and the Stage 1 messages, you might decide to make changes to your code in VisualAge Generator and run Stage 1 again. After you are satisfied with the results of Stage 1 and have your final External Source Format code stored in the migration database, you are ready to perform Stage 2 of the migration. To run the Stage 2 migration tool, you use the WebSphere Studio product. See Stage 2 - Conversion to EGL syntax for information about continuing your migration process.


[ Top of Page | Previous Page | Next Page | Table of Contents | Index ]