Installing and configuring the PAX 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. To download the latest PAX edition, visit IBM® Open Enterprise SDK for Go product page.

Prerequisites

Hardware requirements

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

Software requirements

z/OS® UNIX System Services enabled on z/OS 2.5.0 or later
Note: Go programs need to bind to the LE runtime services using the c89 utility under the z/OS UNIX System Services environment. You may encounter the following error if your c89 utility was 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.
For using cgo (CGO_ENABLED=1):
- XL C/C++ 2.4.1 for z/OS 2.5 with APAR PH27303. You can download the add-on compiler at z/OS Downloads.
- IBM Open XL C/C++ 1.1 to run on z/OS 2.5. You can download the add-on compiler at z/OS Downloads.
- IBM C/C++ for Open Enterprise Languages on z/OS 2.0 to run on z/OS 2.5 with all the following PTFs installed:
  - UI78912
  - UI81095
  - UI80156
  - UI82983
  You can download the PAX edition for this product at IBM C/C++ for Open Enterprise Languages on z/OS 2.0.

Procedure

Install the PAX archive file

250 MB is required to download the PAX archive file.
Minimum 850 MB is required to extract and install Go.
Create a directory <mydir> to hold the extracted PAX files.

Unpax the downloaded file with the following command:

$ cd <mydir>
$ pax -p p -r -f <path to downloaded paxfile>

Environment variables for PAX archive 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)
```