For more information please visit our Web Site at: http://tpf.ncsa.uiuc.edu/

This document outlines the steps needed to build Berkley DB 4.6.21 on the 
IBM z/TPF Enterprise Edition V1 R1 system.
It assumes that you are familiar with the MakeTPF build solution and the
TPF APAR process.

For contact assistance and problem reporting, follow the normal problem
reporting process for z/TPF issues and questions or contact a TPF Customer
Support Representative.

The following naming conventions are used in this document:
   "BDB" refers to the entire Berkely DB package

1. Apply the z/TPF OpenLDAP APAR PJ34028.  BDB is intended to be used for OpenLDAP (PJ34025). 

2. Acquire the BDB source files.

Download and extract the BDB source files from the z/TPF Repository using the
highest posted PUT level, regardless of your actual PUT level:

  a. Download the ztpfbdb.tar.gz file from http://tpf.ncsa.uiuc.edu/
     to your root source directory.
     
     Note: Issues with MS IE and WinZip

       When downloading the ztpfbdb.tar.gz package with Microsoft IE
       for Windows, the name might be changed to ztpfbdb.tar.tar.
       WinZip will fail when trying to extract the package while it is named 
       ztpfbdb.tar.tar.

       To correct this, rename the file back to ztpfbdb.tar.gz and
       WinZip will correctly extract the tarball.

     Notes: 
       Make sure you have "Hide Extensions for Known Types" un-checked in your
       Internet Explorer options so you will actually get access to the file
       extension.
 
       If you are using FTP - please ensure you use Binary transfer mode
  
  b. Unarchive ztpfbdb.tar.gz to your source directory. This package contains
     the tarred source trees for the BDB package with
     additional modifications for the z/TPF system.

     tar zxvfp ztpfbdb.tar.gz
 
     This will create the directory structure opensource/bdb.

3. Apply any APARs listed in the repository following the downloaded PUT level.

4. The required BDB MakeTPF control files were included in apar PJ34028.  
The base/cntl/tpf_bdb.cntl file is used to build the BDB code.  

5. The required MakeTPF environment file was included in apar PJ34028.
The tpftools/include_ztpf/maketpf.env_bdb environment is used to build the BDB code.

6. Check that the makefile for CATS exists in base/openldap/.

The makefile for z/TPF BDB is part of APAR PJ34028 so you do not
have to create them manually.

7. Flip the OpenBDB switch.

Building the BDB support is optional and is controlled by a
a MakeTPF switch called TPF_SBBDB.
TPF_SBBDB was added to tpftools/include_ztpf/maketpf.rules_functionswitch2ksh
and tpftools/include_ztpf/maketpf.rules_functionswitch_defaults by APAR PJ34028.
The BDB= option in macro/sip/config.mac was added for the TPF_SBBDB switch.

Change the BDB= value from NO to YES in xxx/src/sip.asm, where "xxx" is the
system you are building (for example: bas, bss, wp).
This will set the TPF_SBBDB switch on.

Enter the following to run SIP:
   bldtpf -f -sip xxx/src/sip.asm

8. Build the BDB segments by entering the corresponding maketpf:
   maketpf -f CATS

These create opensource/unix/output/load/PPPPvv.so
(where "PPPP" is the segment name and "vv" is the USER_VERSION_CODE in
your maketpf.cfg configuration file).

There should be no warnings nor errors.

 
[This document was last updated 2008-10-06]