Table of Contents Previous Next PDF

Bringing Up bankapp on Workstations

Bringing Up bankapp on Workstations
The following sections describe the procedure for bringing up bankapp, the Oracle Tuxedo system sample application, on a Windows or UNIX workstation:
Characteristics of a Workstation Application
In a workstation application, client processes are moved off the native site. The listener process (WSL) runs with a well-known network address and starts surrogate workstation handlers (WSH) as needed. Servers run on one or more machines within the Oracle Tuxedo administrative domain.
Existing servers are available to run on the Oracle Tuxedo system nodes in either single processor (SHM) or multiprocessor (MP) mode.
On Workstations, the sample applications are located in the following directories:
Bringing Up bankapp on a Workstation Client
The following illustration shows the steps in bringing up bankapp on a Workstation client.
Figure 4‑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 “Tutorial for bankapp, a Full C Application” in Tutorials for Developing Oracle Tuxedo ATMI Applications and in the following README files on the master machine where your Oracle Tuxedo system software is installed:
Editing the Configuration File
You need to edit the configuration file you plan to use (either ubbshm or ubbmp) to specify the workstation listener (WSL) as a server 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.


WSGRP GRPNO=<next available group #> LMID=SITE1

CLOPT=”-A — -n //
machine:port -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.
Loading and Booting the Configuration
Before you can start using a Workstation client, you need to run tmloadcf(1) to load the configuration file into its binary form and tmboot(1) 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 Oracle 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 “Tutorial for bankapp, a Full C Application” in Tutorials for Developing Oracle Tuxedo ATMI Applications.
See Also
tmloadcf(1) in Oracle Tuxedo Command Reference
WSL(5) in Oracle Tuxedo File Formats, Data Descriptions, MIBs, and System Processes Reference
“Tutorial for bankapp, a Full C Application” in Tutorials for Developing Oracle Tuxedo ATMI Applications
“Defining a Workstation Listener (WSL) as a Server” in Setting Up an Oracle Tuxedo Application
Setting the bankapp Variables
To set your environment to run bankapp, complete the following procedure on the Workstation client.
WSNADDR=<WSL advertised address(es)>
WSTYPE=<type of Workstation machine>
Include %TUXDIR%\bin (Windows) or $TUXDIR/bin (UNIX) in your PATH.
Building the bankapp Client
To build a client program, enter the following commands:
mkfldhdr bankflds
buildclient -w -o bankclt -f bankclt.c
Running the bankapp Client
To run the bankapp client on the Workstation, complete the following procedure.
Verify that the value of WSNADDR on the Workstation client matches the value of the CLOPT -n option for the WSL in the SERVERS section of the configuration file on the native site.
If bankapp has not been booted on the native site, make sure it has been booted before you attempt to run a Workstation client.
Execute bankclt to run the Workstation client.

Copyright © 1994, 2017, Oracle and/or its affiliates. All rights reserved.