Sample Applications

This chapter provides instructions for running the simpapp sample applications delivered with Oracle Tuxedo for OpenVMS. The other sample applications are documented in the Read Me file located in the sample applications directory.

•

simpapp

simpapp

This section provides a procedure for building, configuring, running, and shutting down a sample application based on simapp (a sample application delivered with Oracle Tuxedo).

Before you begin, make sure that:

•	TUXDIR is installed on DKA100:[Tuxedo].

•	The logical name APPDIR is pointing to DKA100:[TUXAPP].

Now you are ready to begin.

1.	Build the client and server executables (simpcl and simpserv, respectively):

a.	Verify that all the post-installation steps have been performed and that all the logical names and the symbols were created properly. Please see the "Post-Installation" chapter for more information.

b.	Copy all the files from DKA100:[Tuxedo.APPS.SIMPAPP] to DKA100:[TUXAPP]. The copied files include SIMPCL.C, SIMPSERV.C, README.vms, and UBBBSIMPLE.

c.	On the command line, generate the client executable: buildclient -o SIMPCL.EXE -f SIMPCL.C

d.	Define the symbol for SIMPCL.EXE: SIMPCL:==$ DKA100:[TUXAPP]SIMPCL.EXE

e.	Generate the server program: buildserver -o SIMPSERV.EXE -f SIMPSERV.C -s "TOUPPER"

2.	Modify UBBSIMPLE.

a.	Assign a unique integer value to IPCKEY.

b.	Assign DKA100:[TUXAPP] to APPDIR.

c.	Assign DKA100:[Tuxedo] to TUXDIR.

d.	Assign DKA100:[TUXAPP]TUXCONFIG to TUXCONFIG.

e.	Run the hostname command on your machine to determine the name of the machine. Then replace the machine_name entry with the name of your machine.

f.	Run the id command on your VMS machine to determine your UID and GID. Then change the UID and GID values in the *MACHINE section.

3.	Create a binary version of the UBBSIMPLE configuration file. A file named DKA100:[TUXAPP]TUXCONFIG will be created.

$ tmloadcf -y UBBSIMPLE

4.	Boot the application.

$ tmboot -y

5.	Run the simple client.

$ simpcl abc

The simple client calls the TOUPPER service and specifies input: the string abc. TOUPPER converts the string to upper case (ABC) and sends the new string to the client.

6.	Shut down the Oracle Tuxedo sample application.

$ tmshutdown -y