Software Requirements

Eclipse requirements

• Visual COBOL installs the 64-bit Eclipse IDE by default and requires a 64-bit Java installation.
• On SUSE 12, you can only install and use the 64-bit version of Visual COBOL.
• On other platforms, Visual COBOL supports both the 32-bit and the 64-bit Eclipse. You can use the 64-bit Eclipse to create both 32-bit and 64-bit applications.
• The setup file installs Visual COBOL and the 64-bit Eclipse 4.8. After the installation, you can install Visual COBOL as a plug-in into other Eclipse installations available on the same machine. The supported versions are 4.7, and 4.8 for both the 32-bit and the 64-bit Eclipse. See Installing Visual COBOL into other instances of Eclipse.
  Note: On Red Hat platforms, you need Red Hat 7 or later, if you want to install Visual COBOL into Eclipse 4.8.

Other software requirements

Before installing this product, you must have the following software installed on your computer:

• The unzip utility is required by the setup file.

• The "awk", "ed", "sed" and "tar" utilities must be installed and added to the PATH.
• The pax archiving utility is required by the setup file. Pax is distributed with most UNIX/Linux systems but, if it is missing, you must install it separately. To verify pax is installed, run pax --help or pax --version at the command line.
• Required libraries - the 32-bit libraries listed below are required on both 32-bit and on 64-bit Operating Systems for this product to install and work correctly.

  If installing on a 64-bit OS, the 32-bit libraries are not installed by default and must be installed before you start the installation.

  Library	32-bit Library Name	64-bit Library Name	Platform
  			s390	SUSE 12¹	SUSE 151	Red Hat 6.x	Red Hat 7	Red Hat 8
  glibc	glibc-*.i686	glibc-*.x86_64	glibc-*.s390			X	X	X
  libgcc	libgcc-*.i686	libgcc-*.x86_64	libgcc-*.s390			X	X	X
  libstdc++	libstdc++-*.i686	libstdc++-*.x86_64	libstdc++-*.s390			X	X	X
  glibc-locale	glibc-locale-32bit	glibc-locale-2	N/A	X	X
  gtk2	N/A	libgtk-2_0-0-2	N/A	X	X
  gtk2	N/A	gtk2-tools-2	N/A	X	X
  gtk2	N/A	libXcomposite1-0	N/A	X	X
  gtk2	N/A	libgdk_pixbuf-2_0-0-2	N/A	X	X
  gtk2	N/A	gdk-pixbuf-query-loaders-2	N/A	X	X
  gtk2	N/A	libjasper1-1	N/A	X	X
  gtk2	N/A	gtk2-*.x86_64	N/A			X	X	X
  gtk2-x11	N/A	libgthread-2_0-0-2	N/A	X	X
  libXtst	N/A	libXtst6-1	N/A	X	X
  libXtst	N/A	libXtst-*.x86_64	N/A			X	X	X
  glibc-devel	glibc-devel-*.i686	glibc-devel-*.x86_64	N/A			X	X	X
  PackageKit-gtk	N/A	PackageKit-gtk-module-*.x86_64	N/A			X
  PackageKit-gtk3	N/A	PackageKit-gtk3-module-*.x86_64	N/A				X	X
  gtk2-engines	N/A	gtk2-engines.*.x86_64	N/A			X		X
  libcanberra-gtk2	N/A	libcanberra-gtk2-*.x86_64	N/A			X	X	X
  libcanberra-gtk3	N/A	libcanberra-gtk3-*.x86_64	N/A					X
  webkitgtk	N/A	webkitgtk.x86_64	N/A			X
  webkitgtk3	N/A	webkitgtk3.x86_64	N/A				X
  webkit2gtk3	N/A	webkit2gtk3.x86_64	N/A					X
  xterm	Any version	Any version	Any version	X	X	X	X
  unzip	Any version	Any version	Any version	X	X	X	X
  libgnome	N/A	libgnome.x86_64	N/A			X	X
  gcc2	gcc*.i686	gcc*x86_64	X	X	X	X	X	X
  cpp2		cpp*x86_64					X	X
  libnotify-tools3		libnotify-tools*x86_64	X	X	X

  Note:

  • ^¹ On SUSE 12 or 15, you can only install the 64-bit version of Visual COBOL. The glibc-locale-32bit library is still required by the SafeNet Sentinel licensed components.
  • * Additional libraries required to use the core_on_error runtime variable. The gdb packages (for the GNU Project Debugger) can be installed from the install media for your OS.
  • ² On Red Hat these libraries are required to enable COBOL to compile.
  • Libraries marked with an 'X' are not included in the platform and need to be installed separately.
  • ³ For SUSE 12 and later, you might need to install the Notifications Library tools (libnotify-tools). This is to enable notifications to be displayed by the notify-send tool when starting Visual COBOL for Eclipse from a desktop icon. Execute the following command to install the libnotify-tools library:

    zypper install libnotify-tools

  Visit the Red Hat Web site for more information.

• Xterm, the terminal emulator for the X Window System, is part of your UNIX/Linux distribution but is not installed by default. Use your UNIX/Linux installation media to install it.

• Java 8 (64-bit) is required to run the Eclipse IDE. The minimum recommended version is AdoptOpenJDK's OpenJDK 8 (u202) with Hotspot. Java 8 (32 or 64-bit versions), and Java 11 (64-bit version only) are supported for executing JVM COBOL code and for native COBOL and Java interoperability. You can download AdoptOpenJDK's OpenJDK 8 with Hotspot from AdoptOpenJDK's Web site and unpack the archive anywhere on your machine.

  Note: Eclipse does not run using Java 11.

Before you start the installation, you need to set the environment as follows:

• You need to set the JAVA_HOME environment variable. When installing the product, set this variable to a 64-bit Java installation or the installation terminates. For example, execute the following:

  export JAVA_HOME=java_install_dir

  where java_install_dir is the path to the JAVA installation directory such as /usr/java/javan.n

• You need to add $JAVA_HOME/bin to your system PATH variable. To do this, execute:

  export PATH=$JAVA_HOME/bin:$PATH

• You need to set the LANG environment variable to pick up localized messages. The LANG settings are English and Japanese only.