Software Requirements

Eclipse requirements

• The setup file installs Visual COBOL and the 64-bit Eclipse 4.6.0. 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.4, and 4.5 for both the 32-bit and the 64-bit Eclipse. See Installing Visual COBOL into other instances of Eclipse.
• Visual COBOL supports the 64-bit Eclipse IDE as default and requires a 64-bit Java installation.
• 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.

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 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 11 1	SUSE 12	Red Hat 6.x	Red Hat 7
  glibc	glibc-*.i686	glibc-*.x86_64	glibc-*.s390			X	X
  libgcc	libgcc-*.i686	libgcc-*.x86_64	libgcc-*.s390			X	X
  libstdc++	libstdc++-*.i686	libstdc++-*.x86_64	libstdc++-*.s390			X	X
  glibc-locale	glibc-locale-32bit	glibc-locale-2	N/A		X
  gtk2	N/A	libgtk-2_0-0-2	N/A		X
  gtk2	N/A	gtk2-tools-2	N/A		X
  gtk2	N/A	libXcomposite1-0	N/A		X
  gtk2	N/A	libgdk_pixbuf-2_0-0-2	N/A		X
  gtk2	N/A	gdk-pixbuf-query-loaders-2	N/A		X
  gtk2	N/A	libjasper1-1	N/A		X
  gtk2	N/A	gtk2-*.x86_64	N/A			X	X
  gtk2-x11	N/A	libgthread-2_0-0-2	N/A		X
  libXtst	N/A	libXtst6-1	N/A		X
  libXtst	N/A	libXtst-*.x86_64	N/A			X	X
  glibc-devel	glibc-devel-*.i686	glibc-devel-*.x86_64	N/A			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
  gtk2-engines	N/A	gtk2-engines.*.x86_64	N/A			X
  libcanberra-gtk2	N/A	libcanberra-gtk2-*.x86_64	N/A			X	X
  webkitgtk	N/A	webkitgtk.x86_64	N/A			X
  webkitgtk3	N/A	webkitgtk3.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

  Note: ¹ To install Eclipse on SUSE 11 you must have installed SuSe 11 Service Pack 3 or later.

  * 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.

  ** Operating system libraries required for PL/I support on both SUSE and Red Hat.

  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.

• Oracle's Java Platform (64-bit) version 1.8.92 or above is required to run the Eclipse IDE. Java 7 and 8 (32 or 64-bit versions) are supported for executing JVM COBOL code and for native COBOL and Java interoperability. You can download Oracle's Java EE from Oracle's Web site and install it anywhere on your machine.
  Note: On Linux, the RPM installer for Visual COBOL for Eclipse installs a 64-bit version of Java. When you start the installation, if the 32-bit version of Java is already installed on your Linux machine, you might not be able to install Visual COBOL. This is a known issue with the Oracle Java installers for Linux which prevents you from installing both the 32-bit and the 64-bit versions of Java on the same machine. To work around this problem:

  • Download the 64-bit Java distribution in a compressed .tar format from the Oracle Web site.
  • Untar the distribution into a location different from the one used for the 32-bit Java version. For example, untar in /usr/local/java64 and not in /usr/local/java.
  • Set JAVA_HOME and LD_LIBRARY_PATH to the 64-bit version of Java so that it is used to install and run Visual COBOL.

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:

  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.