Installing and running the agent on System z platforms

Follow these instructions to manually extract and compile the Build Forge agent source code on System z. The agent source code for z/OS is provided as uncompiled source only. A binary distribution is not available.

The following software and programs are required:

The c89 compiler and Unix header files. On the z/OS system, the agent runs in the Unix System Services (USS) environment.
The z/OS UNIX shell interface. During installation, you run all commands on z/OS in the z/OS UNIX shell.
The gzip utility.
Note: If gzip is available on the z/OS system, you can extract the tar file on the z/OS system after transferring the source pack to z/OS. If it is not, you must first extract the files on a non-z/OS computer, and then transfer them to the z/OS system.
The Build Forge agent source pack for z/OS: src-bfagent-<version>.tar.gz.

To enable SSL, make sure the following prerequisites are fulfilled:

Enable SSL for client and internal communications. See Enabling SSL for client and internal connections.
The system SSL library must be installed.
Use the latest version of SystemSSL when you compile the agent code.

To install the agent on System z platforms:

Using either the product installation media or the download product image, locate the file for the agent source pack: src-bfagent-<version>.tar.gz.
Copy or download the source pack to a directory on the non-z/OS computer.
At a shell prompt on the non-z/OS computer, extract the tar file from the agent source pack by entering the command:
```
gzip -d src-bfagent-<version>tar.gz 
```
Using ftp or another transfer method, transfer the tar file to the z/OS system as a binary image and place it in a dedicated HFS subdirectory, usually the USS home directory for a user account.
On the z/OS system, run the following commands to build the agent source code:
1. First step: Use ./configure-zos directly if you don't need to enable SSL. Otherwise, you need to provide the -with-system-ssl and its path to the system SSL. Use the latest version of SystemSSL:
  - From BuildForge 8.0.0.1, the bfagent supports TLS v1.2 and TLS v1.1
  - From z/OS, version 1 release 13, is the minimum version that supports TLS v1.2. If you do not have the minimum version requirement, you must compile the bfagent on z/OS without system SSL.
```
pax -rf src-bfagent-<version>.tar -ofrom=ISO8859-1,to=IBM-1047
cd bfagent-<version>/src
tcsh
./configure-zos [--with-system-ssl=<path>]
```
2. After the ./configure-zos script completes, run the following command:
```
./build-zos
```
Note: If you receive errors after the ./build-zos script runs, see Troubleshooting the agent installation on z/OS.
On the z/OS system, place the bfagent.conf file in /etc.
If bfagent.conf is not in /etc, the agent must be started with the -f option. See bfagent reference.
On the z/OS system, place the bfagent executable file in an appropriate location, for example, /usr/bin or /usr/local/bin.
On the z/OS system, run the following command as root:
```
# extattr +p -s bfagent
```
If you are using system SSL, add the system SSL library to PROGRAM CONTROL. Use the following commands.
```
ralter program * addmem('SYS1.SIEALNKE'//nopadchk) uacc(read)
```
On the z/OS system, log in as root and start the agent manually by using the -s option:
```
bfagent -s
```
If security policy does not allow you to log in as root, see bfagent.conf reference and see the instructions for the magic_login setting in bfagent.conf.
The agent runs as a standalone daemon and uses the default agent port 5555. To change default port, use the port setting in bfagent.conf. See bfagent reference.
Note: If the Unix TCP/IP daemon (inetd or xinetd) is installed and active on the z/OS system, you can set up the Build Forge agent to run as a service and start automatically. See Running an agent on UNIX and Linux.
On the z/OS system, use the telnet command to test the connection. See Testing the connection.