VisualAge Generator to Enterprise Generation Language Migration Guide


Running the Stage 3 tool

From the WebSphere Studio Workbench, do the following:

  1. From the File menu, select Import.
  2. Select VAGen Migration from Database and click Next.
  3. Specify your preferences for this stage of migration:
    1. Edit the preferences on the first page, which are described in the following table. The migration tool does not validate any of the Database fields until you tab out of the field. This prevents multiple attempts to connect to the database while you are entering information.

      Figure 58. Preferences to enter on first page of wizard

      Preference
      Meaning Value
      Load Existing File This allows you to select a previously saved Stage 3 preferences file. Click the Choose File button to select an existing .vgmig file. Click the Load File button to retrieve the preferences from that file and display them in the wizard. Optionally, choose and load an existing .vgmig file.
      Database Driver Location This is the location of your DB2 driver. path_to_db2java.zip\db2java.zip
      Database Driver This is the name of your DB2 driver. This value should always one of the following:
      • COM.ibm.db2.jdbc.app.DB2Driver if you are using a local database.
      • COM.ibm.db2.jdbc.net.DB2Driver if you are using a remote database.
      Database Name This is the name of the DB2 database you used in Stage 1 of migration. This value should always be one of the following:
      • jdbc:DB2:databaseName if you are using a local database.
      • jdbc:nodeName:databaseName if you are using a remote database.
      databaseName is the name of the DB2 database you used in Stage 1. VGMIG is the default value for Stage 1.
      Database Schema This is the name of the DB2 database schema you used in Stage 1 of migration. MIGSCHEMA, where MIGSCHEMA is the name of the DB2 schema you used in Stage 1. MIGSCHEMA is the default value for Stage 1.
      Database User ID This is the database user ID you used in Stage 1 of migration. Use the same database user ID that you used for Stage 1. (The default value is your logon ID.)
      Database Password This is the database password you used in Stage 1 of migration. Use the same database password that you used for Stage 1. (The default value is your logon password.)
      Log File Location This is the location where a log file will be written. Enter a valid location (drive and directory) in the file system.
      Log File Name This is the name of the log file where you want the Stage 3 messages to be written. Enter a valid file name.

      Then click Next.

    2. Edit the preferences on the second page, which are described in the following table:

      Figure 59. Preferences to enter on second page of wizard

      Preference
      Meaning Value
      Java or COBOL radio button This choice determines whether the migration tool creates projects that include Java Source folders.

      If you are using WebSphere Studio Site Developer or WebSphere Studio Application Developer, you should always select the Java radio button.

      For other WebSphere Studio projects, you can select COBOL if you only plan to generate COBOL and you plan to run migration in online mode. Selecting COBOL for batch migration can result in projects that do not have the required EGL properties and which are thus not usable.

      Latest version This specifies that the latest version of the desired migration sets should be imported. Select one of the radio buttons.
      Oldest version This specifies that the oldest version of the desired migration sets should be imported. Select one of the radio buttons.
      Override existing files Stage 3 (the import process) uses EGL produced by Stage 2 to create and import the EGL files specified in the Stage 1 report. If EGL files with the same names as the EGL files that Stage 3 is about to import already exist in the workspace, this option determines whether or not those files will be overwritten. Override existing files enables you to specify how you want the Stage 3 migration tool to handle the situation in which the migration set you are currently migrating contains parts that should be placed in a file that is already in your workspace. If you select Override existing files, the Stage 3 migration tool replaces the existing file and includes only those parts that are in the current migration set. If you do not select Override existing files, the Stage 3 migration tool merges any new parts into the existing file. The new parts are placed alphabetically by part type. See Overwriting and merging files for a more complete discussion of the effects of this option.
      Save migrated files to temporary directory This provides the option to save EGL files to a location in the file system. This allows you to access EGL files for multiple versions of a project at the same time. (You can only see one version at a time in the workspace). You can move EGL files directly from here to your repository. If you plan to migrate multiple versions of a migration set, then do the following:
      • Select this box so that each version can be written to a different subdirectory.
      • Specify the Folder under which the subdirectories for the versions will be placed.
      • Do not select Migrate Now. If you select Migrate Now to migrate in online mode, then the Stage 3 migration tool ignores Save migrated files to temporary directory. Migration to a temporary directory can only be done in batch mode.
      • Select Save current configuration to file. Specify the project and file name where the current configuration is to be saved as a .vgmig file. When you run Stage 3 in batch mode, point to the saved .vgmig file to specify your migration preferences.
      Folder This is the directory in which you want to save the EGL files. Each migration set version becomes a subdirectory under the directory you specify for Folder. Specify an existing directory in your file system.
      Migrate Now This specifies that you want Stage 3 to run at this time, rather than just setting up the preferences file to migrate at a later time. You must select either Migrate Now to run Stage 3 in online mode or Save current configuration to file to save your preferences so that you can run Stage 3 in batch mode at a later time. You can select both options if you want to retain a copy of your preferences for later reference. Do not select Migrate Now if you have already selected Save migrated files to temporary directory. Saving to a temporary directory can only be done in batch mode. Selecting Migrate Now indicates that you want to migrate in online mode.
      Save current configuration to file This preferences enables you to save some of the preferences you are specifying in the wizard to a file. You can later run Stage 3 again with the saved preferences by right-clicking on the saved file and selecting Start Migration from the context menu.
      Note:
      If you select this box, you must specify a Path and a File Name. (See the next two rows in this table.)
      You must select either Migrate Now to run Stage 3 in online mode or Save current configuration to file to save your preferences so that you can run Stage 3 in batch mode at a later time. You can select both options if you want to retain a copy of your preferences for later reference. If you select this option, you must also specify the Path and File Name where the current configuration is to be saved as a .vgmig file. When you run Stage 3 in batch mode, point to the saved .vgmig file to specify your migration preferences.
      Path Specifies the project into which the file should be saved. \projectName, where projectName is the name of the project that you want to contain your saved file.
      File Name This specifies the name of the file to which preferences will be saved. fileName, where fileName is the desired name for your file WITHOUT a file extension. The extension .vgmig will automatically be appended for you.

      Then click Next.

    3. Select the migration set to import on the third page. If none are selected, then all of them will be imported.
      Note:
      The Import from VAGen Migration from Database wizard grays out any migration sets for which no parts have been migrated. This prevents you from running the Stage 3 migration tool without first running Stage 2 to convert and store EGL source code in the migration database.
  4. Click Finish.
  5. The migration tool creates the EGL projects, EGL source folder, and EGL packages based on the migration set you selected. The tool extracts the EGL source from the migration database and creates the EGL files based on the migration set. The migration tool also includes import statements and updates the project's EGL build path so that the part references can be resolved.


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