---

5. The bankapp Makefile

---

A Look at the bankapp Makefile

bankapp includes a makefile that makes all scripts executable, converts data entry masks to binary format, converts the view description file to binary format, and does all the necessary precompiles, compiles and builds to create the application servers. It can also be used to clean up when you want to make a fresh start.

Editing bankapp.mk

As bankapp.mk is delivered there are a few fields you may want to edit, and some others that may benefit from a little explanation.

TUXDIR

If you look at bankapp.mk, about 40 lines into the file you come to the following comment and to the TUXDIR parameter:

#
# Root directory of TUXEDO System. This file must either be edited to set
# this value correctly, or the correct value must be passed via "make -f
# bankapp.mk TUXDIR=/correct/tuxdir", or the build of bankapp will fail.
#
TUXDIR=../..

The TUXDIR parameter should be set to the absolute pathname of the root directory of your BEA TUXEDO system installation.

APPDIR

You may want to give some thought to the setting of the APPDIR parameter. As bankapp is delivered, APPDIR is set to the directory where the bankapp files are located, relative to TUXDIR. The section in bankapp.mk is as follows:

#
# Directory where the bankapp application source and executables live.
# This file must either be edited to set this value correctly, or the
# correct value must be passed via "make -f bankapp.mk
# APPDIR=/correct/appdir", or the build of bankapp will fail.
#
APPDIR=$(TUXDIR)/apps/bankapp
#

If you have copied the files to another directory, as is suggested in the README file, you should set this parameter to the name of the directory to which you copied the files. When you run the makefile, the application will be built in this directory.

NATIVE and Other /Host Parameters

There are some parameters in bankapp.mk that apply to /Host. If you do not have that add-on, you should make sure the parameters are commented out or leave them null.

# Directory where the native side source files for CICS host live.
# This file must either be edited to set this value correctly, or the
# correct value must be passed via "make -f bankapp.mk
# NATIVE=/correct/native", or the build of bankapp will fail.
#
NATIVE=$(TUXDIR)/apps/hostapp/cics/native
      ·
      ·
      ·
#
# HOST - set to -DHOST if host credit card processing is desired
#HOST=-DHOST
HOST=
#

Resource Manager

As bankapp is delivered, it expects to use TUXEDO/SQL as the database resource manager. This assumes that you have the BEA TUXEDO system database on your system. If this is not the case, you should set the RM parameter to the name of your resource manager as listed in TUXDIR/udataobj/RM. There is more on this subject in Chapter 6, "Databases for bankapp."

#
# Resource Manager
#
RM=TUXEDO/SQL
#

Running bankapp.mk

When you have completed the changes you wish to make to bankapp.mk, run it with the following command line:

nohup make -f bankapp.mk &

Check the nohup.out file to make sure the process completed successfully.

---

---