gmStudio Documentation

Page tree

Versions Compared

Old Version 30

changes.mady.by.user Mark.Juras

Saved on

compared with

New Version 32

changes.mady.by.user Mark.Juras

Saved on

Key

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

...

  1. Gather VB6/COM codebase:
     
    1. VB6 source code and resource files of type: *.vbp, *.bas, *.cls, *.frm, *.frx, *.ctl, *.ctx, *.dsr, *.dsx, *.res (as applicable). 
      These code files must be organized into directories consistent with your standard VB6 build environment. 
      If possible include only the VB6 code files that you want included in the assessment and the subsequent upgrade effort.

    2. COM binaries referenced by the *.vbp projects explicitly or through classes instantiated by name through statements like CreateObject.
      These COM binaries may include files of type: *.dll, *.ocx. *.tlb, *.exe (include any .NET assemblies if your VB6 code references them through interop).
      These files will typically have to be installed/licensed/registered properly for the VB6 to build.

    3. If available, you may share other documents such as build scripts, help files, coding standards, testing procedures, and other developer documentation.

  2. [Optional] Validate the source codebase by completing a build using the VB6 IDE.  This is not a requirement, but it is a highly recommended step.

  3. Install the gmStudio Trial on the machine with the VB6 and run the New Project Wizard. 

    This will prepare a gmStudio Project workspace folder containing supporting files (e.g. the interface description files (IDFs) for COM API descriptions) and reports.    

    We can join you in a Web Meeting to assist you with this this task if necessary.

    The gmStudio Trial may be downloaded through the downloads page after you have
    completed the Trial Request form and validated your email address.

    Note: the gmStudio Trial License limits the size of systems that may produce Translated code,
    but it does not limit the size of systems that may be processed for assessment preparation and metrics reporting.

  4. Zip the source directory and the gmStudio Project workspace folder.

    We recommend you create two zip files:
    * proj.zip containing the project workspace directory files, and
    * src.zip containing the source directory files.

  5. Upload the resulting zip file(s) to a web folder we setup for you (e.g. OneDrive) or,
    you may upload your zip files to a folder (or a Virtual Machine) that you provision and we will fetch them from there.

...

Metrics Report Transfer Instructions

If you are not able to share code with us, we offer some limited assessment by examining the reports generated by gmStudio from your code in your environment.

Assessment Metrics Gathering for a new project using the Wizard

The easiest way to gather metrics from a new source system is with gmStudio Upgrade Project Wizard.  This Wizard appears by default when you run
gmStudio after a fresh installation or it can be started from the File menu   The wizard will take you through the steps of setting up a gmStudio project,
running assessment translations, and generating assessment report files.  The wizard will also let you send high level project information to us.  
In order to gather and send the detailed reports to us, complete the following steps:

  1. Run through the gmStudio new project wizard. After  
    After the wizard runs, your assessment files will be in the Reports folder and you will be taken to the gmStudio main form.

  2. Open the Reports Folder by clicking [View\Reports] on the main menu

  3. Zip up the files in the report folder using file compression tool

  4. Email the zip file to us or if you prefer we can use a secure transfer through your account on the Great Migrations web site

Assessment Metrics Gathering for an existing project

Section
Column
width30%

For gathering assessment metrics from an existing project.

  1. Add the VBPs to a gmStudio project and run the translations; 
    Note: gmStudio will be in Reporting Only Mode if the project size exceeds license limits

  2. Display the Reports tab
    1. click [Edit Patterns for Code scan] and remove any blanks before the comments (as shown in Figure 1)
    2. check the [All Tasks] option
    3. check the report  items in the Reporting Controls list (as shown in Figure 1)
    4. click [Run Selected Reports]

  3. Open the reports folder by clicking [Open Reports Folder]

  4. Zip up the files in the folder using file compression tool

  5. Email the zip file or if you prefer we can arrange for a transfer a secure web folder.


Info

gmStudio produces most reports as flat text files in tab-delimited format. The reports can be opened in a spreadsheet program
like Microsoft Excel or loaded into a relational database for more in-depth analysis. Please contact us if you would like to
learn more about either of these important topics.

The gmStudio reports are in the Reporting section of the gmStudio users guide.

Column

Figure 1. Running Assessment Reports


...