Package examples.wtc.atmi.simpapp

This example demonstrates the ability of WTC to allow WLS to interoperate with Tuxedo.

See:
Description

Interface Summary

Toupper	The methods in this interface are the public face of the simpapp client.
ToupperHome	This interface is the home interface for the TraderBean.java, which in WebLogic is implemented by the code-generated container class TraderBeanC.

Class Summary

Client	This class illustrates calling a stateful SessionBean and performing the following exercises: Create a Toupper Buy some shares using the Toupper Sell some shares using the Toupper Remove the Toupper
ToupperBean	ToupperBean is a stateful SessionBean.

Package examples.wtc.atmi.simpapp Description

This example demonstrates the ability of WTC to allow WLS to interoperate with Tuxedo.

The Tuxedo simpapp application is extended to run over domains. This allowsclients of the TOUPPER service to run on either Tuxedo or WLS. It consists of a Tuxedo service, TOUPPER, which converts a string to upper case. A WLS client invokes the TOUPPER EJB and connects to the Tuxedo TOUPPER service.

Configure the example

You need to configure Tuxedo and WLS.

Tuxedo configuration

1. Your PATH environment variable needs to include the path of your C compiler. Use set PATH to check the status and add the path if necessary.
2. Copy the simpapp example from your Tuxedo installation and create a working Tuxedo simpapp directory
3. Change directories to the working Tuxedo simpapp directory
4. Set environment variables. Update the following parameters:
   • TUXDIR - base directory of the TUXEDO Software
   • APPDIR - base directory of the sample program
   • PATH - must include %TUXDIR%\bin
   • TUXCONFIG - full pathname of binary tuxconfig file
   NT/2000 users modify setEnv.cmd located at %TUXDIR%. Unix users modify the tux.env file located at $TUXDIR.

   Build the clients:

   buildclient -o simpcl -f simpcl.c

   buildserver -o simpserv -f simpserv.c -s TOUPPER

   Copy the ubbdomain and dom1config files from the WTC simpapp directory to your Tuxedo simpapp directory

   Copy the tolower.c file from the WTC simpserv directory to your Tuxedo simpapp directory

   Modify the ubbdomain for your Tuxedo environment. This includes setting the pathnames for APPDIR, TUXCONFIG, and TUXDIR and setting the machine name. Replace all <bracked> items with information for your environment.

   Example:

   APPDIR="/home/me/simpapp"

   TUXCONFIG="/home/me/simpapp/tuxconfig""

   TUXDIR="/usr/tuxedo"

   Load the ubbdomain file

   Example:

   tmloadcf -y ubbdomain

   Modify the dom1config for your Tuxedo environment. This includes creating log devices and updating the network addresses.

   • Logs

   Example:

   DMTLOGDEV="d:\my_apps\tlog"

   AUDITLOG="d:\my_apps\aud"

   DMTLOGNAME="DMTLOG_TDOM1"

   • NWADDR

   Example:

   TDOM1 NWADDR="//TuxedoMachine:1234"

   TDOM2 NWADDR="//WTCMachine:5678"

   Load the dom1config file

   Example:

   set BDMCONFIG=d:\mydomain\simpapp\bdmconfig

   dmloadcf -y dom1config

   Build the tolower client

   buildclient -v -f tolower.c -o tolower

   Boot the Tuxedo domain

   tmboot -y

   Verify all processes have started using the tmadmin psc command.The following domain processes should have booted:

   • DMADM, GWADM, and GWTDOMAIN

   • The TOUPPER service offered by the simpserv server

   • The TOLOWER service is offered by the GWTDOMAIN server

WLS Configuration

1. Change directories to the WTC simpapp directory
2. Set environment variables. Update the following parameters:
   • Set the APPLICATIONS to the location of the applications directory in your WLS domain
   • Set the CLIENT_CLASSES to build
   NT/2000 users modify and run the setExamplesEnv.cmd. Unix users copy ./config/examples/setExamplesEnv.sh script to your WTC simpapp directory, then modify and run the setExamplesEnv.sh script.

   Build the wtc_toupper.jar file using ant.

   • Enter the following command: ant

   Modify the bdmconfig.xml file with information specific to your installation:

   • Update the DOCTYPE: Use the fully qualified path of the WTC installation.

   • Update the NWAddr attributes of TDOM1 and TDOM2 domains for your environment

   • If you are using a Tuxedo 6.5 service, add Interoperate and set to Yes

   Use the following command to validate the bdmconfig.xml file using the WTCValidateCF utility:

   java weblogic.wtc.gwt.WTCValidateCF bdmconfig.xml

   Change directories to the simpserv directory

   Build the wtc_tolower.jar file using ant.

   • Enter the following command: ant

   Boot your WLS application server

   Check to see that the wtc_tolower.jar and wtc_toupper.jar are deployed. Use the WLS console or check the config.xml file. Manually deploy the EJBs if needed.

   Configure a WTC StartUp Class. You need to provide a classname and the fully qualified name of the bdmconfig.xml file you are using for the example.

   • Set the classname to: weblogic.wtc.gwt.WTCStartup

   • Set the arguments field to: BDMCONFIG=path_name_of_your_bdmconfig.xml_file

   Configure a WTC ShutDown Class

   • Set the classname to: weblogic.wtc.gwt.WTCShutdown

   Shutdown and restart your WLS application server.

   • The TOUPPER and Tolower EJBs are deployed in your WLS application server

Run the example

Start a WLS client to invoke the TOUPPER EJB and connect to the Tuxedo TOUPPER service.

1. Change directories to the WLS simpapp directory
2. Start a client
   • For NT/2000, use the following command: run.cmd allcaps
   • For Unix, use the following command: run.sh allcaps
   Example:

      run allcaps

   The Tuxedo service replies to your WLS application with:

      Returned string is: ALLCAPS

Use TraceLevel

If you have a problem running the simpapp example, use the WTC tracing feature. Add the TraceLevel parameter to the StartUp Class Argument list.

Example:

   BDMCONFIG=path_to_my_bdmconfig.xml_file,TraceLevel=20000

A TraceLevel of 20000 traces all of the calls to the Tuxedo object in the client.

There's more...

You are ready to run the simpserv example.

For more information about WebLogic Server WebLogic Tuxedo Connector, see:

• WebLogic Tuxedo Connector Administration Guide
• WebLogic Tuxedo Connector Programmer's Guide
• WebLogic Tuxedo Connector Examples
• Javadocs for the WebLogic Tuxedo Connector