Using the Oracle Tuxedo ATMI Workstation Component

     Previous  Next    Open TOC in new window    View as PDF - New Window  Get Adobe Reader - New Window
Content starts here

Using Workstation on a Windows System

The following sections describe additional information about using the Oracle Tuxedo ATMI Workstation component on a Windows XP or Windows Server 2003 system:

 


Benefits of Using Workstation on a Windows System

The Windows instantiation of the Workstation client offers significant benefits to application developers:

 


Software Prerequisites

The software prerequisites for running the Workstation component on a Windows system are as follows:

 


Writing Client Programs

You can develop client programs targeted for Windows workstations in the same way that you would develop native client programs within the Oracle Tuxedo system administrative domain. All the ATMI functions are available.

Interoperability Restrictions for Workstation Clients

Interoperability between Oracle Tuxedo release 7.1 and later Workstation clients and applications based on pre-7.1 releases of the Oracle Tuxedo system is supported in any of the following situations:

An Oracle Tuxedo release 7.1 or later Workstation client with multiple threads in a single context cannot interoperate with a pre-7.1 release of the Oracle Tuxedo system.

Building Client Programs

To compile client programs written in C, you can use any compiler that can read Microsoft C import libraries. To compile COBOL source programs that call the ATMI, use the LITLINK option of the COBOL compiler. For details, see “COBOL Language Bindings for the Workstation Component” in Programming an Oracle Tuxedo ATMI Application Using COBOL.

Use buildclient(1) with the -w flag to link-edit your client programs.

You can also build Oracle Tuxedo clients without using the buildclient(1) utility. If you are using Microsoft Visual C++ projects, use the following settings:

In addition, set the INCLUDE, LIB, and PATH search directories appropriately.

Building GUI ATMI Clients

The sample/atmi/ws directory contains several different windows platform .mak files for creating GUI atmi clients. For an example of how these files may be used, see Tutorial for bankapp, a Full C Application in Tutorials for Developing Oracle Tuxedo ATMI Applications.

Run Time

When you run client programs, your PATH must includoTUXDIR%\bin.

Limitations

The Oracle Tuxedo libraries (DLLs) prior to Oracle Tuxedo release 7.1 are not thread-safe. For applications written using the pre-release 7.1 DLLs, threads should not be used; otherwise, threaded access is serialized through all Oracle Tuxedo calls (such as ATMI, FML, userlog(), and so on).

See Also

 


How a Multithreaded or Multicontexted Workstation Client Joins an Application

To join an Oracle Tuxedo application, a multithreaded Workstation client must always call tpinit(3c) with the TPMULTICONTEXTS flag set, even if the client is running in single-context mode.

See Also


  Back to Top       Previous  Next