Creating a Tuxedo Client Program

A BEA Tuxedo client is a software module that collects a user request and forwards it to a server that offers the requested service. To create a Tuxedo client with ACUCOBOL-GT, you must relink the ACUCOBOL-GT runtime with the Tuxedo libraries. This section provides an overview of the steps necessary to create the Tuxedo client.

1. Add the necessary Tuxedo calls to your ACUCOBOL-GT program. These calls–used to open and close resources, begin and end transactions, and support communication between clients and servers–are collected in a Tuxedo API known as the Application to Transaction Monitor Interface (ATMI). ATMI functions are described in the Tuxedo documentation.
2. Recompile your program to establish it as a BEA Tuxedo client.
3. Relink the ACUCOBOL-GT runtime on the client machine to include the BEA Tuxedo client libraries. The client libraries vary, depending on the BEA Tuxedo version and the platform you are using. To determine the Tuxedo client libraries used on a particular client, use the BEA Tuxedo command:

   buildclient -C -v -w 

   where:

   C	Specifies COBOL compilation
   -v	Specifies that buildclient should work in verbose mode, displaying the compilation command on standard output
   -w	Specifies that the client is to be built using the workstation libraries; used only with the WSL

   Because the Tuxedo libraries are external C routines, link the libraries into the ACUCOBOL-GT runtime using the direct method of calling C routines described in.

4. Set client environment variables.