Page tree

Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Suppose you are interested in upgrading-to-.NET a number of VB6 projects, as listed in the example below:

D:\gmSamples\newsamples\FMstocks\src\FMSLib\FMSStore_Bus_VB6\FMSStore_Bus.vbp 
D:\gmSamples\newsamples\FMstocks\src\FMSLib\FMSStore_DB_VB6\FMSStore_DB.vbp
D:\gmSamples\newsamples\FMstocks\src\FMSLib\FMSStore_Events_VB6\FMSStore_Events.vbp
D:\gmSamples\newsamples\FMstocks\src\FMSLib\FMSTest_VB6\FMSTest.vbp
D:\gmSamples\newsamples\FMstocks\src\FMSLib\FMStocks_Bus_VB6\FMStocks_Bus.vbp
D:\gmSamples\newsamples\FMstocks\src\FMSLib\FMStocks_DB_VB6\FMStocks_DB.vbp
D:\gmSamples\newsamples\FMstocks\src\FMSLib\FMStocks_Ext_VB6\FMStocks_Ext.vbp

In this example, the Migration Set contains 7 VB6 projects (.vbp), all located in the following source directory tree:

[WorkDir]\src, where [WorkDir] is D:\gmSamples\newsamples\FMstocks

Interface Description Files (IDFs)

...

In gmStudio, select [File][Upgrade Project Wizard …] and press [Next] when ready

Image Modified

 


Step 2. Specify Source Input Parameters

...

Press [Next] when ready to move on with the selected list of projects (seven (7) in this case)

Image Modified



Step 3. Specify Target Output Parameters

...

  1. Enter a "Project Name" for your Translation Project
  2. Select a target "Language" (C# or VB.NET) for the translation
  3. Select the "Target IDE" (the version of Visual Studio .NET installed on your machine)
  4. Select a "COM Strategy" ("Stub Framework" by default)
  5. Select a "Project Folder" where the results (outputs) of the translation will be written
  6. Take all other default selections for "Batch Processing Options"
  7. Press [Next] when ready to move on with the actual translation


Image Modified


In this example, all translation outputs will be written in the following output directory tree:

[WorkDir]\proj, where [WorkDir] is D:\gmSamples\newsamples\FMstocks

Step 4. View Upgrade Process

...

  1. Press [Next] to move on to reviewing the results of the translation process.

    Image Modified



    Step 5. Continue

    In the Form below, press the [No, thank you … Next] button, to move on.

    Image Modified

    Step 6. Review Metrics Summary

    In the Form below, press the [Finish] button, to move on.

    Image Modified



    Step 7. Review Results

    The Form below shows the Main Screen of the FMSLib Upgrade Project that was set up by the previous Steps (Steps 1 – 6), including the Interface Description Files ("IDFs") that were generated from all the externals (libraries or components) referenced by all the VB6 projects in this Upgrade Project.
    1. From the Title Menu, select [View][Interface Description Files] to move to the next step.

      Image Modified



      Step 8. Review Generated Interface Description Files (IDFs)

      The snapshot below shows a listing of the IDFs (*.xml text files) contained in the …\idf\FromIdl folder, as generated by gmStudio for all the externals referenced in this Upgrade Project. These are contained in following directory:

      [WorkDir]\proj\idf\FromIdl.


      Image Modified

       


      Step 9. Archive IDFs for Distribution

      In File Explorer, select the [WorkDir]\proj\idf\FromIdl folder and right-click [Send to][Compressed (zipped) folder] in order to compress all of the IDFs into a zip file, FromIdl.zip, as shown below.

      Image Modified


      At this point, these IDFs will be ready to "ship" for use in gmStudio – on a machine that may not have the corresponding externals properly registered (or licensed in the case of licensed third-party components).