Page tree
Skip to end of metadata
Go to start of metadata

You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 18 Next »


If your license allows it, gmStudio can be operated in a batch mode.  You will typically do this using the sample batch files we provide. This section describes the gmStudio command line.

gmStudio Command Line Syntax

The form of the gmStudio command line is as shown below:

gmStudio /AUTOBATCH = ["YES"|"NO"] /CFG="cfgpath" /MIG="migpath" /TOOLS="tool_list" /TASKS="task_list" /REPORTS="report_list" [/IGNOREMRU] [/LOGSTART] [/LOGALL] where:


If AutoBatch=YES then the command list specified in the migration project file (.gmproj) will be performed. Otherwise, the set of task/tools specified on the command line will be performed.

/CFG = "cfgpath" sets the path to an application config file (gmstudio.cfg) /MIG = "migpath" sets path to a migration project file (.gmproj)


/MIG = a migration project specification string: one of more of the following semicolon delimited list of project creation parameters:





name is the name of new upgrade project

optional, default=NewUpgrade


source is the name of the folder containing the source codes



lang is the target .NET language (csh|vbn)

optional, default=csh


sendto is the name of the folder to store the project workspace



pattern is *.vbp|*.asp|fully qualified path to a single file



'yes' indicates to use extension methods (aka. the lightweight object oriented coding style) and 'no' indicates to standard dialect

optional, default=yes


'yes' indicates to generate a stub framework for COM and 'no' indicates to use interop

optional, default=yes


VSnnnn is a VSversion name (e.g. VS2010, VS2010, VS2015)

optional, default=VS2013


'yes' means to replace a pre-existing gmProj silently and 'no' indicates to promot the user

optional, default="no"


See sample listing below:


/FILTER = "sourcelist" restricts processing to the source tasks listed. Multiple tasks indicated using '+'. Wildcard using '*'.

/TOOLS = "tool_list" specifies a comma delimited list of the following tools (iterate over all migration units for each tool)

      Apply Task Filter,
      Author Interop Assemblies,
      Author Interface Descriptions,
      Set Build Order,
      Author Resx Files,
Generate Visual Studio Solution,
Update Project Metalang File 

 /TASKS = "task_list" specifies a comma-delimited list of the following tasks (iterate over list of all tasks for each migration unit)

       Validate Source,
Build VB6, 
Snapshot a Baseline, 
Reset Task Status, 
Run Translation, 
Deploy Translation, 
Build Translation,
Run Functional Test 

/REPORTS = "report_list" specifies a comma-delimited list of reports (See Reports Article for more information)

      Source Structure,
      Source References,
      Source Members,
      Source GUI Scan,
      Source Code Scan,
      Project Summary,
      Metrics Summary,
      Migration Set,
      Interface File Headers,
      Interface File ProgIds,
      Code Bundles,
      .NET Build Logs,
      Translation Logs,
      All Logs,
      Semantic References,
      Semantic Definitions,
      Semantic Symbols,
      Semantic Audit,
Generate Visual Studio Solution,
Migration Project List,
Target Code Scan,

Note that tools are processed before tasks.

/IGNOREMRU: do not reload most recently used project 

/LOGSTART: create a diagnostic log of startup information.  The file will be written to C:\Users\<NAME>\AppData\Roaming\GreatMigrations\gmstartup.*.log

/LOGALL: create a diagnostic log of session information.  The file will be written to C:\Users\<NAME>\AppData\Roaming\GreatMigrations\gmstartup.*.log

Sample Command Script

    • RunGmStudio.cmd: allows running gmStudio for a specific project from the command line 

Sample for using Command Line Project Creation

C:\gmSamples\_Testing>gmStudio.exe /MIG="Name=FileExplorer;Source=C:\gmTestBed\FileExplorer\src;SendTo=C:\gmTestBed\NewProj\FileExplorer;netLang=csh;VSVersion=VS2013;OverWrite=yes" /AUTOBATCH="YES"

Counting LOC: C:\gmTestBed\FileExplorer\src\FileExplorer.vbp
Computing Project Summary for C:\gmTestBed\NewProj\FileExplorer\FileExplorer.gmProj
Creating Project
User Settings or Defaults
Name               =FileExplorer
Source             =C:\gmTestBed\FileExplorer\src
NetLang            =csh
SendTo             =C:\gmTestBed\NewProj\FileExplorer
Filter             =*.vbp
UseExtensions      =True
UseStubs           =True
VSVersion          =VS2013
Computed Parameters
txtMigName         = FileExplorer
txtProjFolder      = C:\gmTestBed\NewProj\FileExplorer
txtgmProjPath      = C:\gmTestBed\NewProj\FileExplorer\FileExplorer.gmProj
txtJobTag          = std
totLoc             = 590
txtDeployFolder    = %ProjFolder%\deploy
txtVirtualRoot     = C:\gmTestBed\FileExplorer\src
txtTlbSearchPath   = C:\Windows\system32
isNew              = True
optStyleExtensions = True
optCOMtoInterop    = False
askReplacegmProj   = False
cmbMigType         = VBP
jobType            = jobVbp
Project Settings (as of 3/10/2017 5:50:10 PM)
Name                     = [FileExplorer]
Upgrade Type             = [VBP]
Target IDE               = [VS2013]
TaskFilter               = [*|*|*|*|*|*|*|*|*|*|*|*|*|*|*|*|*|*|*|*|*|*]
Batch Commands           = [Apply Task Filter,Set Build Order,Author Interface Descriptions,Run Translation,Deploy Translation,Build Translation,]
Project Folder           = [C:\gmTestBed\NewProj\FileExplorer]
Deployment Folder        = [%ProjFolder%\deploy]
Virtual Root Folder      = [C:\gmTestBed\FileExplorer\src]
Project License          = []
COM Search Paths         = [C:\Windows\system32]
.NET Language            = [csh]

Project Metrics
Task Tag                 = [std=1]
.NET Language            = [csh=1]
VB6 Build Status         = [?=1]
Source Lines             = [SUM=590] LOC
Translation Script       = [tran.FileExplorer_std.xml=1]
Task Command Script      = [UserCmds.cmd=1]
Dependencies Status      = [?=1]
Translation Status       = [?=1]
.NET Lines               = [SUM=?] LOC
.NET Build Status        = [?=1]
Build Type               = [Exe=1]

Project Files and Folders
Migration Project Path        FOUND       2017-Mar-10 17:50:10 [C:\gmTestBed\NewProj\FileExplorer\FileExplorer.gmProj]
COM TypeLib Search            FOUND       2017-Feb-24 14:29:53 [C:\Windows\system32]
Source Root                   FOUND       2017-Mar-09 15:20:06 [C:\gmTestBed\FileExplorer\src]
Workspace Folder              FOUND       2017-Mar-10 17:50:10 [C:\gmTestBed\NewProj\FileExplorer]
User Configuration Folder     FOUND       2017-Mar-10 17:50:10 [C:\gmTestBed\NewProj\FileExplorer\usr]
Working Folder                FOUND       2017-Mar-10 17:50:10 [C:\gmTestBed\NewProj\FileExplorer\log]
Deployment Root Folder        FOUND       2017-Mar-10 17:50:10 [C:\gmTestBed\NewProj\FileExplorer\deploy]
Report Folder                 FOUND       2017-Mar-10 17:50:10 [C:\gmTestBed\NewProj\FileExplorer\report]
Session Log Folder            FOUND       2017-Mar-10 17:50:10 [C:\gmTestBed\NewProj\FileExplorer\log]
Runtime Assemblies            FOUND       2017-Mar-10 17:50:10 [C:\gmTestBed\NewProj\FileExplorer\deploy\bin]
IDFs From COM                 FOUND       2017-Mar-10 17:50:10 [C:\gmTestBed\NewProj\FileExplorer\idf\FromIdl]
IDFs from Code                FOUND       2017-Mar-10 17:50:10 [C:\gmTestBed\NewProj\FileExplorer\idf\FromCode]
Resx Folder                   FOUND       2017-Mar-10 17:50:10 [C:\gmTestBed\NewProj\FileExplorer\resx]
**** gmStudio Batch Session
Start   = 3/10/2017 5:50:10 PM
Project = C:\gmTestBed\NewProj\FileExplorer\FileExplorer.gmProj
Starting Batch...
TOOLS: Apply Task Filter,Set Build Order,Author Interface Descriptions,
TASKS: Run Translation,Deploy Translation,Build Translation,
Apply Task Filter
Set Build Order
No Build Order Needed; only 1 tasks selected.
Author Interface Descriptions
Loading Interface Cache
Scanning References: C:\gmTestBed\FileExplorer\src\FileExplorer.vbp
Generating Interface Description for: stdole2.tlb
Generating Interface Description for: scrrun.dll
Generating Interface Description for: MSCOMCTL.OCX
Generating Interface Description for: richtx32.ocx
Updating Interface Cache
Validating: C:\gmTestBed\FileExplorer\src\FileExplorer.vbp
Validation Complete (0 unresolved types)
Run Translation
Translating C:\gmTestBed\FileExplorer\src\FileExplorer.vbp
Deploy Translation
Deploying: C:\gmTestBed\NewProj\FileExplorer\log\FileExplorer-FileExplorer-std-csh.bnd
Build Translation
Building: C:\gmTestBed\NewProj\FileExplorer\deploy\FileExplorer\FileExplorer.csproj
Batch Complete. Elapsed Time= 00:00:01.934



  • No labels