Tuxedo WS .NET Wrapper Administration Guide

Copyright © 2005 BEA Systems, Inc. All rights reserved.

 

Table of Contents

Overview

Installation

   Prerequisites

   Installing the wrapper package

Uninstall

 

Overview

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.

Installation

Prerequisites

You must perform the following steps on the target environment before starting to install the Tuxedo WS .NET wrapper software package:

l       You must have .NET Framework version 1.1 or higher installed on the target machine.

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.

Installing the wrapper software package

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.

Uninstall

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.