Skip to content
Great Migrations
Blog

Processing Steps

This section describes the types of steps gmStudio performs for you when it processes a migration project.

Default Processing

Section titled “Default Processing”

When you first create a Migration Project, gmStudio assigns it a full complement of automated preparation and translation steps. The set of steps depends on the external handling strategy.

Default Prototype Migration Steps

Section titled “Default Prototype Migration Steps”

The default batch steps for a Prototype (aka. Stub) migration are as follows:

  1. Apply Task Filter (select all migration tasks)
  2. Set Build Order
  3. Author Interface Descriptions
  4. Author Resx Files
  5. Run the translation with BuildFile=“Local”
  6. Deploy Translation
  7. Build Translation

Default Interop Migration Steps

Section titled “Default Interop Migration Steps”

The steps for an Interop migration are as follows:

  1. Apply Task Filter (select all migration tasks)
  2. Set Build Order
  3. Author Interface Descriptions
  4. Author Interop Assemblies
  5. Author Resx Files
  6. Run Translation with BuildFile=“Off”
  7. Deploy Translation
  8. Build Translation

Optimizing Batch Processing

Section titled “Optimizing Batch Processing”

The default processing for a new migration includes a number of steps that you will typically only have to run during the initial preparation phase of your migration work or when the source codebase changes in a significant way.

For example:

  • Apply Task Filter — you should only select this when you want the subsequent batch steps to apply to all migration tasks in your project. This makes sense for the initial preparation, but once you start doing iterative translation tuning, you will typically focus you efforts on a select set of migration units. See the discussion of the Task Filter Form in the FAQ for more details.
  • Set Build Order — you should only select this during initial preparation or when you want to recompute the order because the dependencies between migration units has changed.
  • Author Interface Descriptions — you should only select this during initial preparation or when you want to update IDFs because external dependencies of your migration project have changed.
  • Author Interop Assemblies — you should only select this during initial preparation or when you want to update interop assemblies because external dependencies of your migration project have changed. Note this is not needed for pure Prototype migrations.
  • Author Resx Files — you should only select this during initial preparation or when the source code of your user interface files (forms, controls) have changed.

In summary, if your source codebase is stable and you have successfully completed the preparation work, then the set of processing steps you will typically run is:

  • Run Translation
  • Deploy Translation
  • Build Translation

To change batch processing steps:

  1. Select [Tools/Batch Control] from the menu to display the Batch Control Form.
  2. Check or Clear the check box for each step you want to turn on or off respectively.
  3. Click Start to Save your preferences and run the batch process.

Your selections are saved to your migration project file.