Tuxedo .NET Workstation Client - libwsclient.dll Options

codeling Posts: 1153 Points: 4845
Posted: Tuesday, January 3, 2017 1:15:32 PM

For Microsoft .NET programmers, Tuxedo .NET Workstation Client is a facilitating tool that will help to efficiently develop Tuxedo .NET Workstation Client applications. Besides providing a set of Object Oriented (OO) interfaces to .NET programmers, this tool allows you to design and write code in OO styles.

For Tuxedo programmers, the Tuxedo .NET Workstation Client inherits most ATMI function invocation behavior which makes it easier to understand and use .NET Client classes to write applications. Because the Tuxedo .NET Workstation Client is published as a .NET assembly, it also leverages the benefit of .NET Framework. It can be used with many .NET programming languages (for example, C#, J#, VB .NET, and ASP.NET).

The Tuxedo .NET Workstation Client contains the following components:

This Microsoft .NET Framework .dll assembly wraps Tuxedo ATMI and FML functions for developing Tuxedo .NET workstation clients.

These executable utilities help to develop C# code using Tuxedo VIEW/VIEW32 and FML/FML32 typed buffer and compile C# code to Tuxedo .NET Workstation Client executable assemblies. For more information, see viewcs, viewcs32(1), mkfldcs, mkfldcs32(1), buildnetclient(1).

These three samples explain how to create Tuxedo .NET Workstation Client application using C#. See Tuxedo .NET Workstation Client Samples.

  • A wrapper assembly: libwsclient.dll
  • A set of utilities: viewcs, viewcs32; mkfldcs, mkfldcs32; and buildnetclient
  • Sample applications: callapp, fmlviewapp, and unsolapp

codeling Posts: 1153 Points: 4845
Posted: Tuesday, January 3, 2017 1:25:56 PM

The Tuxedo .NET Workstation Client has the following limitations:

  • It exclusively supports developing Tuxedo workstation clients with .NET languages. It does not support developing Tuxedo native clients or Tuxedo servers in a .NET environment.
  • New Tuxedo 9.0 ATMI functions are not included in the Tuxedo .NET Workstation Client package (for example, tpxmltofml32(3) and tpfmltoxml32(3)).
  • Tx Transaction interfaces (for example: tx_open(), tx_close(), and tx_begin()), are not supported by Tuxedo .NET Workstation Client. Only Tuxedo TP transaction functions (for example: tpopen(), tpclose(), and tpbegin()) can be used.
  • Tuxedo .NET workstation Client implementation requires ATMI client functionality. During the Tuxedo installation, the Full Install Set and .NET Client Install Set automatically include the ATMI Client Install Set.
  • Microsoft .NET Framework 2.0 or later must be installed in order to use the Tuxedo .NET Workstation Client. Microsoft .NET Framework is not bundled with the Tuxedo .NET Workstation Client package.

codeling Posts: 1153 Points: 4845
Posted: Tuesday, January 3, 2017 1:32:41 PM

You can manually register/un-register libwscdnet.dllin the global assembly cache from the command line.

 To register enter:

c:\Program Files (x86)\Bea Systems\tuxedo\bin>gacutil.exe /i libwscdnet.dll
Microsoft (R) .NET Global Assembly Cache Utility.  Version 4.0.30319.1
Copyright (c) Microsoft Corporation.  All rights reserved.

Assembly successfully added to the cache

gacutil.exe /i %TUXDIR%\bin\libwscdnet.dll.

 

To unregister enter:

gacutil.exe /u libwscdnet.dll.


codeling Posts: 1153 Points: 4845
Posted: Friday, November 22, 2019 2:08:02 PM

A Tuxedo client is a software module that collects a user request and forwards it to a server that offers the requested service. To create a Tuxedo client, you must link the client with the Tuxedo libraries, for example, if you want to create a Tuxedo .NET Workstation Client application, then you have to implement the application by calling ATMI api in the assembly libwsclient.dll. Normally, these calls are used to open and close resources, begin and end transactions, and support communication between clients and servers.

Pseudo-code for a Request/Response Client

main()
 {
      allocate a TPINIT buffer
      place initial client identification in buffer
      enroll as a client of the BEA Tuxedo application
      allocate buffer
      do while true {
           place user input in buffer
           send service request
           receive reply
           pass reply to the user }
      leave application
 }
Users browsing this topic
Guest