[Top] [Prev] [Next] [Bottom]

4. Sample Applications

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

simpapp

This section provides a procedure for building, configuring, running, and shutting down a sample application based on simapp (a sample application delivered with the BEA TUXEDO system).

Before you begin, make sure that:

Now you are ready to begin.

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

    1. 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.

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

    3. On the command line, generate the client executable.

      buildclient -o SIMPCL.EXE -f SIMPCL.C

    4. Define the symbol for SIMPCL.EXE.

      SIMPCL:==$ DKA100:[TUXAPP]SIMPCL.EXE

    5. Generate the server program.

      buildserver -o SIMPSERV.EXE -f SIMPSERV.C -s "TOUPPER"

  2. Modify UBBSIMPLE.

    1. Assign a unique integer value to IPCKEY.

    2. Assign DKA100:[TUXAPP] to APPDIR.

    3. Assign DKA100:[TUXEDO] to TUXDIR.

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

    5. 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.

    6. Run the getuidgid 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 BEA TUXEDO sample application.

    $ tmshutdown -y

Configuration Issues for COBOL simpapp

Keep in mind the following issues when using the simpapp sample application on an OpenVMS platform:

csimpcl.cob

csimpsrv.cob

tpsvrinit.cob


[Top] [Prev]