This is an old revision of the document!



Ispirer Home Page Ispirer SQLWays Migration Product Page Request SQLWays

How To Migrate Progress4GL to .NET Using Command Line

To migrate Progress 4GL code to .NET technology in command line mode can be used SQLWays.exe command line tool. This tool is included in the Ispirer Migration and Modernization ToolKit as a main core tool that do the conversion between databases and applications.

Registration

If you run the SQLWays.exe tool for the first time, you need to register the tool using the license information that you have. You can register the toolkit using the SQLWays Wizard tool. Here you can find step by step guide on how to run and register the tool. Please follow the steps described in the article:

How to Run And Register The Toolkit

Conversion

After you registered the toolkit you need to run the following command in the Command Prompt:

 c:\Program Files\Ispirer\MnMTK2015\SQLWays.exe" /D=FIXED /SOURCE= Progress 4GL /TARGET=CS /F=c:\example\*.* /DIR=ResultCS\ /INI=sqlways.ini /TBLDDL=Tables_ddl.sql



Description of the used command line options:

  • c:\Program Files\Ispirer\MnMTK2015\SQLWays.exe - path to the SQLWays.exe command line tool that will run the conversion.
  • /F – path to the source files that should be converted.
  • /DIR - path to the folder where the conversion results will be saved
  • /INI - path to the options file (.INI file where all the options supported by Ispirer Migration And Modernization ToolKit are located)
  • /SOURCE - option that defines source technology (database or application)
  • /TARGET - option that defines target technology (database or application)
  • /TBLDDL - path to the Tables_DDL.sql file. This is the file with the MSSQL table definitions. This file is used by the SQLWays.exe tool in order to apply correct conversion of columns, data types and JOINS.


Options In the Options File


To convert your Progress 4GL source code, please specify the following options in the sqlways.ini file:

 [Common]
 DSN=c:\Root\
 REGISTRATION_NAME=RegName
 TARGET_DB=MSSQLServer
 
 [CS]
 ENTITY_MODEL_NAME=your_EntityModelName
 ENTITY_MODEL_NAMESPACE=your_EntityModelNameSpace
 DATA_MODEL=EDM
 UI_TYPE=WinForms
 GENERATE_CSPRJ=Yes
 COMPILED_QUERIES=Yes
 CONVERT_DEPEND_LIBS=no
 TEMP_TABLES_PREFIX=false
 GENERATE_TRANSACTIONSCOPE=yes
 PROJECT_NAMESPACE=your_namespace
 SAVE_4GL_QUERIES=yes
 GENERATE_SYSTEM_PARAMETERS=YES 
 [PROGRESS4GL] 
 PARSER_PR_4GL=UNIX
  • DSN=c:\Root\ - full path to source folder for correct coloring of call of functions from libraries.
  • REGISTRATION_NAME= - is mandatory for your company.
  • TARGET_DB= - specifies the target database.
  • DATA_MODEL= - specifies the data model.
    • ENTITY_MODEL_NAME= - specifies the name of your sql schema.
    • ENTITY_MODEL_NAMESPACE= - to identify the name of database model.
  • UI_TYPE= - specifies Windows Forms technology for migration if there is any UI logic.
  • GENERATE_CSPRJ= - creates VS project file (but in that case Entity Model should be added manually).
  • COMPILED_QUERIES= - defines whether the LINQ Compiled queries should be generated.
  • CONVERT_DEPEND_LIBS= - specifies that dependent libraries should be ignored after migration of Progress 4GL procedures if libraries are not selected for migration. Please note this option doesn't not switch off the reading of all necessary information from libraries required for procedures, it means that libraries will be migrated independently.
  • TEMP_TABLES_PREFIX= - defines whether the “tt” prefix should be removed from the temporary tables.
  • GENERATE_TRANSACTIONSCOPE= - generates TransactionScope for 4GL transactions.
  • PROJECT_NAMESPACE= - specifies project namespace.
  • SAVE_4GL_QUERIES= - - allows to see source 4GL queries in comments inside the converted target code.
  • GENERATE_SYSTEM_PARAMETERS= - add to constructor declarations of initial parameters.
  • PARSER_PR_4GL= - allows to parse unix escape characters.


Ispirer Note:

 To use EDM model please do the following steps:
 1.   Create in root source directory folder “db”
 2.   Rename your edmx model file to “DataClasses.edmx” and place it in “db” folder


If you will face with some issues or have some questions on how to migrate Progress 4GL code to .NET in command line, please contact our support team: support@ispirer.com


Ispirer Home Page Ispirer SQLWays Migration Product Page Request SQLWays


© 1999-2024, Ispirer Systems, LLC. All Rights Reserved.