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:
-
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
-
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.
- 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=
- 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
andMortgageApplication/build/file.yaml
files are provided as examples. They are equivalent toMortgageApplication/build/build.properties
andMortgageApplication/build/file.properites
. For more information, see How to organize the build script. - Edit
-
Configure the build script.
Edit
MortgageApplication/build/build.sh
and set theDBB_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.