Copyright © 2005 BEA Systems, Inc. All rights reserved.
Installing the wrapper package
The Tuxedo WS .NET wrapper provides connectivity between .NET workstation applications and Tuxedo services. Windows .NET developers can create workstation clients in any programming languages targeting .NET CLR to access Tuxedo ATMI services. This software package contains:
l
A wrapper API set for developing
.NET/Tuxedo workstation clients
l A wrapper runtime environment for running Tuxedo
workstation clients written for .NET CLR.
It consists of an assembly code libwscdnet.dll and a Win32 native dll libwdi.dll.
l
Samples explaining how to create
.NET/Tuxedo workstation clients using C# with the wrapper API.
You must perform
the following steps on the target environment before starting to install the
Tuxedo WS .NET wrapper software package:
l
You must use the appropriate
wrapper installation package.
For Tuxedo 9.0, use the Tux90-DotNet-WS.tar.gz installation package.
l Tuxedo must be installed on the target machine. The latest release
(Tuxedo 9.0) is recommended.
Note: The Tuxedo WS .NET wrapper has not been fully tested (and hence
not guaranteed to work properly) with Tuxedo releases prior to 9.0.
l Make sure that environment variables have been set correctly:
- TUXDIR must be set to the Tuxedo installation directory
- PATH must include the directory where .NET framework’s executables are located, and
- LIB must include both the directory where .NET framework’s libraries are located and the directory where Tuxedo libraries are located.
Once you have unpacked the Tuxedo WS .NET Wrapper software, perform the following steps:
1.
Unpack the wrapper installation package to a temporary
directory.
There are supposed to be 8 files under that directory:
viewcs.exe,
viewcs32.exe, mkfldcs.exe, mkfldcs32.exe, buildnetclient.exe, libwscdnet.dll libwdi.dll and install.bat.
2.
Open a command window, enter the directory from the
command line, and manually input/execute install.bat.
Note: Prior to executing install.bat, the TUXDIR environment variable
must be set correctly, and PATH must include the directory where the .NET framework executables and
libraries are located. For example, C:\WINNT\Microsoft.NET\Framework\v1.1.4322.
In order to uninstall the .NET Wrapper
from the system, you need to do the following:
l Make sure that the TUXDIR environment variable is set correctly and PATH includes the directory where the .NET framework executables and libraries are located.
l Open a command window, execute the command “gacutil /u libwscdnet” to remove registered libwscdnet.dll from .NET framework’s global assembly cache.
l Enter the directory %TUXDIR%\bin and use the command line (or Windows Explorer) to remove viewcs.exe, viewcs32.exe, mkfldcs.exe, mkfldcs32.exe, buildnetclient.exe, libwscdnet.dll and libwdi.dll.