Converting Net Express Projects to Visual Studio Projects

Visual COBOL includes a Net Express Project Import wizard that enables you to import existing Net Express projects into Visual Studio and convert them to Visual Studio projects.

The wizard analyzes the Net Express project file, its configuration settings and dependencies, and creates one or more Visual Studio native projects based on this information. It then imports the existing source code into the new projects, and sets the project and file properties that were used in the original Net Express project. The wizard also produces a detailed conversion report.

The Net Express Project Import wizard takes the following information from the Net Express project:
  • file dependencies and all output file types produced by the project
  • the type of application that is being built, such as a console application or a library
  • the build configurations such as Generic Debug Build and Generic Release Build
  • the paths for copybooks that are not in known locations such as the solution folder tree, links from the solution, and the cpylib folder in the installation
  • the Compiler directives and build settings
  • how the application starts, such as any command line arguments
Note: If you have any questions or comments about converting Net Express projects or about upgrading to Visual COBOL in general, please use the Micro Focus Community pages (http://community.microfocus.com/) to get in touch with us and other Visual COBOL users.

The structure of a Net Express project is similar to that of a Visual Studio solution, where the solution represents a whole application. A solution can contain multiple projects, each one producing a single or multiple output files. The final application can then contain a mixture of .exe, .dll, .int and .gnt files.

  • Depending on the output files they produced in the available configurations (for example, Generic Debug Build, Generic Release Build, or a custom build type), Net Express projects convert to different Visual Studio project types as shown below:
    Files created by the Net Express project Visual Studio project type after the conversion
    A single output file A single Visual Studio project
    A mixture of executable files - .exe and .dll files Multiple Visual Studio projects in the same solution, each of which produces a single executable – an .exe or a .dll file.
    .int or .gnt files only A multi-output INT/GNT project that contains the programs which compiled to .int or .gnt. The project produces a single .int or .gnt file, equivalent to the output of the original Net Express project.
    Note: .gnt files that were part of the Net Express cannot be used in Visual COBOL and are ignored.
    .lbr files only For each .lbr in the Net Express project, the wizard creates a corresponding INT/GNT project that compiles to a single .lbr file.
    Note: The .lbr files produced by Visual COBOL can only contain COBOL programs and cannot include data files.

    You can copy any data files that are part of the project to the output folder but they will exist as separate files and will not be packaged in the .lbr. You can use the Copy To Output Directory property in the data file properties to configure this.

    A combination of different output file types (.int, .gnt, .lbr, .exe or .dll) Multiple projects in the Visual Studio solution, each of which produces output files as detailed above.
    A project that does not contain any executable targets (exe, lib or dll) A project that holds the application-level dependencies so they get copied into the main output directory.
  • Copybook paths are determined by how the Visual Studio project is structured and by what dependency each file has. If a file depends on another file in a different folder, that folder is added to the copybook paths.
  • The Compiler directives are taken from the Net Express project and are set by enabling options in the Visual Studio project and file properties for the Debug, Release or any other custom configurations. Any directives that do not have corresponding options in the project or file properties are added to the Additional Directives field in the project or file properties.

For more on upgrading Net Express applications to Visual COBOL, see Upgrading to Visual COBOL.