Installing and configuring the SMP/E edition

Planning for installation requires three main tasks: ensuring you have the correct hardware and software installed, choosing the right default location, and setting up the environment variables accordingly. For specific installation requirements and instructions of the product, see chapter 5 and 6 of the Program Directory.

Prerequisites

Hardware requirements

IBM® z16™
IBM z15®
IBM z14®/z14 model ZR1
IBM z13®/z13s®

Software requirements

z/OS® UNIX System Services enabled on z/OS 3.1. PTFs for the following APARs are required to enable Go:
- OA62757
- PH57159
For using CGO (CGO_ENABLED=1), you can use the following C compilers:
- IBM Open XL C/C++ 1.1 with UI93306 installed
- IBM C/C++ for Open Enterprise Languages on z/OS 2.0
z/OS UNIX System Services enabled on z/OS 2.5 . PTFs for the following APARs are required to enable Go
- OA62757
- PH45182
For using cgo (CGO_ENABLED=1), you can use the following C compilers:
- XL C/C++ 2.4.1 for z/OS 2.5 with APAR PH27303.
- IBM Open XL C/C++ 1.1
  - UI78912
  - UI81095
  - UI80156
  - UI82983
- IBM C/C++ for Open Enterprise Languages on z/OS 2.0 with all the following PTFs installed:
  - UI78912
  - UI81095
  - UI80156
  - UI82983

Notes:

You can download XL C/C++ 2.4.1 for z/OS 2.5 at z/OS Downloads.
You can download IBM Open XL C/C++ 1.1 at z/OS Downloads.
You can download the PAX edition for IBM C/C++ for Open Enterprise Languages on z/OS 2.0 at the download site.
Go programs need to bind to the Language Environment® runtime services by using the c89 utility under the z/OS UNIX System Services environment. You might encounter the following error if your c89 utility is not set up correctly:
```
FSUM3052 The data definition name SYSLIB cannot be resolved. The data set was 
not found. Ensure that data set name CEE.SCEEBND2 is specified correctly.        
open /tmp/go-build794287247/b001/exe/hello: EDC5129I No such file or directory.
```
For details on how to fix this error, see Cannot locate CEE.SCEEBND2 data set.

Procedure

Configuration

IBM Open Enterprise SDK for Go is an OMVS-based application, which requires certain configuration on the z/OS UNIX System Services file system to ensure proper operation.

Validate that /usr/bin/env exists.
Ensure that /tmp has at least 860 MB or more of disk space configured. To use an alternative file system, you can set the TMPDIR environment variable to a directory that has sufficient space.

Default installation location for IBM Open Enterprise SDK for Go: The default Go SMP/E installation location on z/OS is /usr/lpp/IBM/cvg/v1r20/IBM/.

Environment variables for SMP/E installation

Set the following environment variables before using IBM Open Enterprise SDK for Go.

If you use cgo, configure the COMPILER_PATH environment variable:

export COMPILER_PATH=<path to xlclang command>
eval $(<go installation path>/go/etc/goz-env)

If you do not use cgo, use the following command:
```
eval $(<go installation path>/go/etc/goz-env)
```