Overview
Restriction: This topic applies to Windows environments only.
The
Import and Convert NetExpress Projects wizard enables you to convert existing
Net Express projects into Eclipse projects so you can use them with
Visual COBOL. The wizard analyzes the
Net Express project file and its configuration setting. It then creates the required Eclipse projects, imports the source files into them and sets the required project and file properties from the original
Net Express project for one of its build types.
- Net Express projects can have different types of build, each one of which could include different files and different project and file-level settings. Eclipse projects only support one set of file settings that are used for all build configurations. Because of this, the
Import and Convert NetExpress Projects wizard only imports the files and settings for one build type of a
Net Express project at a time. This build type is used as the default build configuration for the new Eclipse project. If the project includes more than one build type, you need to repeat the import process to create Eclipse projects that have the set of files and settings for the other build types.
- An Eclipse project can have only one target type per build configuration, so if the
Net Express project builds into more than one target types, the wizard suggests to create multiple Eclipse projects.
- The wizard creates a single Eclipse project for all the .int and .gnt targets produced by the
Net Express project, and the
Target Type for this Eclipse project is set as
All Int/Gnt Files.
The properties that are set during the import include:
- the type of application that is being built, such as a console application or a library
- the paths for copybooks that aren't in known locations such as the project directory, and the
cpylib folder in the installation
- the Compiler directives and build settings
- how the application starts, such as any command line arguments
If the
Net Express project builds more than one type of target, the wizard suggests the creation of multiple Eclipse projects.
Tip: If you have any questions or comments about the
Import and Convert NetExpress Projects wizard or upgrading to
Visual COBOL, please use the Micro Focus Community pages (
http://community.microfocus.com/Home) to get in touch with us and other
Visual COBOL users.
To import a
Net Express project into Eclipse
- Ensure that your
Net Express project and all relevant files are available and in one location.
- In the Eclipse IDE, click
, expand
Micro Focus, click
Convert NetExpress Projects, and click
Next.
- In the
Import and Convert NetExpress Projects dialog box, click
Browse to navigate to and select the
Net Express project you want to convert.
If your
Net Express project built to
.int and
.gnt files, you can change the target types so that you have just
.dll and
.exe build configurations. To do this, check
Upgrade projects to use executable/library targets.
- Click
Finish.
The wizard analyzes the
Net Express project and lists the Eclipse projects it will create, which Net Express Type of Build will be used for the new projects, and the file settings that will be used.
You can change the target type at any time after you have converted the project. If you don't want a project for a particular build target (for example, if you want to use a debug configuration instead of having a separate project for an
.int file in the
Net Express project), you can choose not to create a project from that target.
- For each Eclipse project, verify that the
Net Express type of build is the one you want to use as a basis for the new project.
- Click
OK.
Depending on the build configurations and the target types of the
Net Express project, the wizard creates one or more Eclipse projects and a conversion report file in a new folder,
eclipse, in the same directory as the
Net Express project folder. The source files of the
Net Express project are not copied into the
eclipse folder. They are stored in the
Net Express folder and are linked to from the Eclipse projects.
If your
Net Express project uses resource files, you should move the files from the
MainProjectSource group in COBOL Explorer to the relevant new
Visual COBOL project folder.
Note: Resource files provide a way of adding non-executable binary data such as bitmaps, cursors and menus to an executable file. Within these files the data can be stored in full, or indirectly as a pointer to another named file that contains the actual data. Resource files have the extension
.rc.
Restrictions and limitations
- The following
Net Express Compiler directives are obsolete and are ignored during the import:
- 01SHUFFLE
- 64KPARA
- 64KSECT
- AUXOPT
- CHIP
- COBIDY
- DATALIT
- EANIM
- EDITOR
- ENSUITE
- EXPANDDATA
- FIXING
- FLAG-CHIP
- MASM
- MODEL
- OPTSIZE
- OPTSPEED
- PARAS
- PROTMODE
- REGPARM
- SEGCROSS
- SEGSIZE
- SIGNCOMPARE
- SMALLDD
- TABLESEGCROSS
- TRICKLECHECK
- WB2
- WB3
- WB
- The pseudovariables of the following
Net Express environment variables are obsolete and are ignored during the import:
- BASENAME
- FILENAME
- PATH
- TARGETDIR
Other pseudovariables are replaced with the closest possible value and any substitutions are reported in the log file.
- If you import a
Net Express project that uses functionality that is not supported in
Visual COBOL, the wizard still produces an Eclipse project. In some cases you might be able to perform additional steps (such as editing source files, installing AddPacks, or reworking parts of the application) in order to successfully compile and run it.
For more on migrating
Net Express applications to
Visual COBOL, see
Upgrading to
Visual COBOL.
