The Process Diagrammed
Figure 9-1 shows the steps in the process of bringing up bankapp on workstations, and also provides an outline of the subjects in this chapter.
Figure 9-1 Steps in bringing up bankapp
Changes on the Native Site
Install and build the bankapp software on the native site. The procedure for doing this is described in the BEA TUXEDO Application Development Guide and in the README file found in $TUXDIR/apps/bankapp on the master machine where your BEA TUXEDO system software is installed.
New Configuration File Parameters
You need to edit the configuration file you plan to use (either ubbshm or ubbmp) to specify the workstation listener server, WSL, in the GROUPS and SERVERS sections and to specify MAXWSCLIENTS in the MACHINES section. When you edit the GROUPS section, put the entry for WSGRP ahead of the DEFAULT line or move the specifications for TMSNAME and TMSCOUNT to the server groups that use them; they should not be assigned to WSGRP. The new specifications should be in the following format.
*MACHINES
DEFAULT: MAXWSCLIENTS=50
#
*GROUPS
WSGRP GRPNO=<next available group #> LMID=SITE1
#
*SERVERS
WSL SRVGRP=WSGRP SRVID=1
CLOPT="-A - -n 0x0002ffffaaaaaaaa -d /dev/tcp -m 1 -M 5 -x 10"
Also, remember to increase the MAXACCESSERS parameter in the RESOURCES or MACHINES section to cover the new workstation clients.
Load and Boot the Configuration
At some point, before you can start using /WS clients, you need to run tmloadcf to load the configuration file into its binary form and tmboot to start the application. These commands do not have to be run immediately; there is work to be done in getting the bankapp clients installed on your workstations and getting them built. However, the application must be running on the BEA TUXEDO system native site when you attempt to join the application from a workstation. The steps for loading and booting bankapp on the native site are part of the overall procedure documented in the BEA TUXEDO Application Development Guide.
bankapp on a UNIX Workstation
This section covers the installation of bankapp client programs on a UNIX workstation.
Install the Files
The source files shown in Listing 9-1 are the bankapp files that you need to copy from TUXDIR/apps/bankapp to the client workstation.
Listing 9-1 Files for UNIX /WS clients
BALANCE.m Mask for balance inquiry data entry.
CBALANCE.m Mask for confirmation of a balance inquiry.
CCLOSE.m Mask for confirmation of an account closing.
CDEPOSIT.m Mask for confirmation of an deposit.
CLOSE.m Mask for account closing data entry.
COPEN.m Mask for confirmation of an account closing.
CTRANSFER.m Mask for confirmation of a transfer.
CWITHDRAW.m Mask for confirmation of a withdrawal.
DEPOSIT.m Mask for deposit data entry.
HELP.m Mask that explains mio keystrokes
MENU.m Initial mask that offer a ring menu
to choose deposit, withdrawal, transfer, balance inquiry,
open account, or close account data entry screens.
OPEN.m Mask for open account data entry.
TRANSFER.m Mask for transfer data entry.
WITHDRAW.m Mask for withdrawal data entry.
aud.v FML view used to define structure passed between
audit client the BAL server.
audit.c Source code for audit client program.
bank.flds Field table file containing bank database fields
and auxiliary FML fields used by masks and servers.
bank.h Contains data definitions pertinent to more than
one C program within the application.
bankvar Contains environment variable and sets those contained
in ENVFILE.
credit.flds Field table file containing credit card fields used by
masks and servers.
driver.sh Drives the application by piping FML buffers
with transaction requests through wud(1).
envfile.sh envfile ENVFILE Creates ENVFILE for use by tmloadcf.
gendata.c Generates wud(1) readable transaction request to
add ten branches, thirty tellers and two hundred accounts.
gentran.c Generates wud(1) readable transaction requests
from among the DEPOSIT, WITHDRAWAL, INQUIRY, and TRANSFER services.
populate.sh Populates the database by piping FML buffers generated
by gendata through wud(1).
run.sh Invokes mio with MENU mask.
wsbankapp.mk Application makefile for UNIX workstations.