Contribute in GitHub:

Installing and configuring DBB samples

The samples are provided as in a form to be loaded into a Git repository. The entire samples directory is created as a repository with a number of examples included. Setting up the entire samples as a Git repository is described along with configuring the specific Mortgage Application sample that is provided. The Mortgage application is used for validating the installation of DBB.

Procedure

Create an empty repository in your Git server.
Clone or download the repository from https://github.com/IBM/dbb by using either of the following methods:
1. Clone with SSH: Fork https://github.com/IBM/dbb to your user name and clone the repository to your local system.
```
git clone git@your_username/dbb.git
```
2. Choose Download ZIP on https://github.com/IBM/dbb and extract the downloaded file to the repository.
Configure the properties files for the Mortgage Application build scripts.
1. Edit MortgageApplication/build/build.properties by providing sandbox information for the build. An example from the file is provided below. Make sure all the items are specified.
```
Absolute path of the source directory that contains `.git`
sourceDir=
```
1. Edit MortgageApplication/build/datasets.properties by providing a fully qualified DSN for each property. The first four examples are shown below to demonstrate what is required. All the fields must be provided for the sample application to work.
```
# z/OS macro library. Example: SYS1.MACLIB
MACLIB=

# LE (Language Environment) load library. Example: CEE.SCEELKED
SCEELKED=

# High Level Assembler (HLASM) load library. Example: ASM.SASMMOD1
SASMMOD1=

# Cobol Compiler Data Set. Example: COBOL.V6R1M0.SIGYCOMP
SIGYCOMP=
```
You can also write YAML files to configure the build. The MortgageApplication/build/build.yaml and MortgageApplication/build/file.yaml files are provided as examples. They are equivalent to MortgageApplication/build/build.properties and MortgageApplication/build/file.properites. For more information, see How to organize the build script.
Configure the build script.

Edit MortgageApplication/build/build.sh and set the DBB_HOME variable to where the DBB toolkit is installed on z/OS.
```
# Set the DBB bin directory for example /var/dbb
DBB_HOME=
```
Add the files with the git add command.
```
git add
```

Commit the changes.

git commit -m "New Samples with local customization"

Push the changes to the Git server.
```
git push
```

The samples are now available for cloning to z/OS.