Software Requirements

The setup file will check your machine for whether the prerequisite software is installed and will install any missing prerequisites and the product components. A supported version of Microsoft's Visual Studio must be installed in advance.

Besides the software listed below, the setup file also installs the 64-bit AdoptOpenJDK 11.0.8 (LTS) with Hotspot.

This product includes OpenSSL version 1.1.1n-mf6 (modified).

Visual Studio IDE

You must have Microsoft's Visual Studio 2019 version 16.11 or a newer one installed in advance.

Important:
  • If using Visual Studio 2022 version 17.10 or later, you must install Patch Update 16 or later of this release, in order for this product to work as expected. This Patch Update addresses a breaking change introduced in Visual Studio.
  • To continue using .NET 6 in versions of Visual Studio 2022 17.8 or newer, you need to download and install the .NET 6 SDK from the Microsoft website.
Note: Problems with Microsoft's Visual Studio 2022, release 17.2, might cause the following issues with Visual COBOL or Enterprise Developer for Visual Studio 2022. The issues do not exist in release 17.1. See the points below for the workarounds to these issues:
  • An issue with Microsoft's Visual Studio installer might result in the IntelliSense and editor colorization not working. To repair your installation, execute the following command from a Visual Studio command prompt:
    devenv /updateconfiguration
  • Mixed-language multi-project builds might fail as a result of the project dependencies not working correctly. This means that some projects might build in parallel when they should build in a specific order. As a result, the build might fail due to a dependency not always being available. To work around this issue, click Tools > Options > Preview Features, and check Load projects faster (some features may be delayed).
  • The expanded copybook visualizations are missing. This includes breakpoint, current statement when debugging, and others. These features might not always function correctly in non-expanded source (in the main programs) if that program contains expanded copybooks. To work around this issue, you can disable inline copybook expansions.

You need one of the advanced versions of Visual Studio listed below:

  • Professional, Enterprise or Community Edition - see the next section for the Visual Studio components you must install.

Microsoft's Visual Studio Express Edition is not supported.

Important:
  • When installing Visual Studio, ensure you select the Help Viewer component for installing if you want to view the Visual COBOL product help inside Visual Studio. When you select components to install in the Visual Studio installer, click Individual components and check Help Viewer in the Code tools section.

The following software is also required:

  • Microsoft .NET Framework 4.7.2. This is included with Visual Studio.

Selecting the Visual Studio components to install

The Visual Studio installer enables you to customize and only install the workloads and components that are most suitable for your area of development. For example, you can select the components that are required for .NET desktop development, ASP.NET Web or C++ development.

If not already installed, the Visual COBOL setup file will install the following components:

  • .NET Framework version 4.7.2.
  • Debugger
  • Data services

A number of workloads and components are optional and only required by specific types of applications or tasks:

  • Azure, WCF, Web, WPF, MSVC, or SQL CLR application development.
Important: The latest version of the C++ x64/x86 build tools component, which is part of the MSVC Workload, is required to generate some IMTK clients.

If you require any of these, you can select them when you start the Visual Studio installer or, enable them after completing the installation - see the next section.

Installing Visual Studio features that are not currently installed

If a feature of Visual Studio was not installed during the Visual Studio installation, the respective functionality or the project templates for it are not available. You can install a missing feature in one of the following ways:

Rerun the Visual Studio installer:

  1. Start the Visual Studio installer and choose to modify an existing Visual Studio instance.
  2. Select the workloads and the components that are missing (for example, ASP.NET and web development or Help Viewer).
  3. Start the Visual Studio installation.

Use the Quick Launch control in Visual Studio:

  1. Start Visual Studio.
  2. Type the name of the feature in the Quick Launch control - for example, type ASP.NET or Help Viewer.

    A drop-down list with any features matching your search string appears. If the feature is not already installed, one of the search results will be an option to install it.

Use the Install Missing Feature(s) command in Visual Studio:

  1. Start Visual Studio.
  2. Click Help > Micro Focus Product Help > Install Missing Feature(s) > Feature Name.

    Follow the instructions in the installer to install the missing feature.

  3. Alternatively, if a Micro Focus project template requires a Visual Studio feature which is not currently installed, the IDE displays an information bar with instructions to install the feature.

License Manager requirements

  • The Micro Focus License Administration tool requires Java to run. It supports Java 1.7 or later.
  • For local servers, you do not need to install the Micro Focus License Administration tool separately, as the setup file installs a new Visual COBOL client and a new licensing server on the same machine.
  • If you have any network license servers, you must update them before you update the client machines.
  • If you are upgrading from Visual COBOL release 2.2 or earlier, uninstall the license manager before installing the product.
You can download the new version of the license server software by following these steps:
  1. Log into the Software Licenses and Downloads (SLD) site at https://sld.microfocus.com/mysoftware/download/downloadCenter.
  2. Select your account and click Downloads.
  3. Select a product and a product version from your orders.
  4. In the list of software downloads, locate the License Manager.
  5. Click Download to download an archive with the installers.
  6. Run the installer suitable for your Operating System to install License Manager on your machine.

Other Requirements

Various actions and operations within your COBOL development environment depend on certain files that Microsoft distributes in the following packages: the Windows SDK package and the Microsoft Build Tools package. See Microsoft Package Dependencies for a full list of actions and operations that require one or both of these packages.

By default, the product installation installs the latest versions of the Microsoft Windows 10 SDK, and the Microsoft Build Tools for Visual Studio 2019, to their default locations.

If you need to use any other version of these packages, or use them installed to a non-default location, use the cblms command line utility post-installation to manage this; see Managing the Microsoft Build Tools and Windows SDK Packages for more information.