Prerequisites

The following prerequisites must be installed and configured for IBM® Enterprise Edition for Galasa.

Java JDK

Required. Galasa tests are written in Java™. IBM Semeru Java Development Kit version 11 or 17 is supported for IBM Enterprise Edition for Galasa. After installing, you must set the JAVA_HOME environment variable to your Java JDK installation path. To check that the JAVA_HOME environment variable is set successfully run echo $JAVA_HOME on MacOS terminal or echo %JAVA_HOME% on Windows command line. The returned result shows the path to your JDK installation. Also use java --version to show the direct command version.

Maven

Required. Maven is required in order to build Galasa projects. Galasa projects are hierarchical file structures that provide the ability to store and run Galasa tests.

Docker

Optional. Required to use the optional Docker image for hosting the local Maven repositories.

Terminal emulator with 3270+ support

Optional. Although you do not need a 3270 emulator to run a Galasa test (even if it tests a 3270 application) you can use one to explore Galasa Simbank offline, a simulated version of an application that helps you get acquainted with Galasa before connecting to a real mainframe to run your own tests. There are many such emulators available but IBM's Personal Communications (PCOMM) is frequently used, as is IBM's Host on Demand software, which includes support for Windows, Linux® and MacOS. The IBM Developer for z/OS Remote Connection Emulator is also an option. A good source emulator to emulate a 3270 machine would be to use IBM Host on Demand this can be found in the IBM App Store.