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.
Prerequisites
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:
- First step: .configure-zos. Note the use of –with-system-ssl.
You provide the path to the system SSL. Use the latest version of
SystemSSL.
pax -rf src-bfagent-<version>.tar -ofrom=ISO8859-1,to=IBM-1047
cd bfagent-<version>/src
./configure-zos --with-system-ssl=<path>
- After the ./configure-zos script completes, run the following
command:
./build-zos
- 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, Linux, and MacOS.
- On the z/OS system, use the telnet command to test the connection.
See Testing the connection.