Tuxedo .NETワークステーション・クライアントの使用

Tuxedo .NETワークステーション・クライアント・アプリケーションの作成

このトピックには次の項が含まれます:

概要

Microsoft .NETプログラマにとって、Tuxedo .NETワークステーション・クライアントは、Tuxedo .NETワークステーション・クライアント・アプリケーションの開発を効率化する、生産性向上ツールです。このツールでは、.NETプログラマとのインタフェースがオブジェクト指向(OO)であるだけでなく、コードの設計および記述もOO手法で行うことができます。

Tuxedo .NETワークステーション・クライアントは、ATMIの関数呼出しの動作をほとんどすべて継承しています。そのため、Tuxedoプログラマは、.NETクライアントのクラスを簡単に理解し、使用して、アプリケーションを記述できます。Tuxedo .NETワークステーション・クライアントは、.NETアセンブリとして公開されるため、.NET Frameworkの利点も活用されます。.NETワークステーション・クライアントは、さまざまな.NETプログラミング言語(たとえば、C#、J#、VB.NET、およびASP.NET)で使用できます。

Tuxedo .NETワークステーション・クライアントでは、.NETプログラミング言語でTuxedoクライアント・アプリケーションを記述して、Tuxedoサービスにアクセスできます。また、.NETワークステーション・アプリケーションとTuxedoサービスの間の接続機能も備わっています。

Tuxedo .NETワークステーション・クライアントには、以下のコンポーネントが含まれています。

制限

Tuxedo .NETワークステーション・クライアントには、以下の制限事項があります。

Tuxedo .NETワークステーション・クライアントの機能

Tuxedo .NETワークステーション・クライアントは、.NETアプリケーションとTuxedoワークステーションの基底の共有ライブラリ(libwsc.dll、libengine.dll、およびlibfml.dll)の間の中間層またはラッパーとして機能します。図1は、Tuxedo .NETワークステーション・クライアントの機能を表しています。

.NETアセンブリのlibwscdnet.dllには、Tuxedo .NETワークステーション・クライアント用のラッパーAPIクラスが含まれ、Tuxedo ATMI関数とFML関数をラップするオブジェクト指向スタイルのインタフェース・セットを実装します。

buildnetclientは、.NETプログラミング言語で記述されたTuxedoワークステーション・クライアントを構築するため、libwscdnet.dllを参照します。それは共通言語ランタイム(CLR)環境をターゲットとしており、実行時の環境に応じて、アセンブリ(たとえば、クライアントの実行可能ファイル、ライブラリ)によって呼び出されます。

win32共有ライブラリlibwdi.dllにはlibwscdnet.dllに使用されているプラットフォーム固有の関数が実装されています。

Microsoft .NET Framework

Tuxedo .NETワークステーション・クライアントを使用するには、Microsoft .NET Framework 4.0または4.5 SDKをご使用のシステムにインストールする必要があります。Oracle Tuxedoのインストーラ・プログラムでは、.NET Frameworkがインストールされているかどうかが自動的にチェックされます。インストールされている場合は、libwscdnet.dllが.NET Frameworkのグローバル・アセンブリ・キャッシュに自動的に登録されます。

.NET Frameworkがインストールされていない場合は、インストールする必要があります。.NET Frameworkは、Microsoftの.NET Developer Centerからダウンロードできます。.NET Frameworkのインストール後は、libwscdnet.dllをグローバル・アセンブリ・キャッシュに手動で登録することを強くお薦めします。

libwscdnet.dllは、コマンド行から登録/登録解除できます。

登録するには、次のとおりに入力します。

登録を解除するには、次のとおりに入力します。

Tuxedo .NETワークステーション・クライアント・アプリケーションの開発

Tuxedo .NETワークステーション・クライアント・アプリケーションを開発するプログラマは、以下のことを行う必要があります。

Tuxedo .NETワークステーション・クライアントは、プログラマによるTuxedo FML/VIEW型バッファの使用および.NET実行可能ファイルのビルドを支援する開発ユーティリティを備えています。「FML/FML32型バッファ」と「VIEW/VIEW32型バッファ」を参照してください。

Tuxedo .NETワークステーション・クライアントのプログラミング

Tuxedo .NETワークステーション・クライアントのインタフェースの主な変更点(Tuxedo ATMIおよびFMLのC関数との比較)は、以下のとおりです。

Tuxedo .NETワークステーション・クライアントのネームスペース

Tuxedo .NETワークステーション・クライアントのネームスペースは、2つのカテゴリに分類されます。最初のカテゴリには、2つのネームスペースBea.Tuxedo.ATMIとBea.Tuxedo.FMLがあり、ATMIおよびFMLのラッパー・クラスがまとめられています。

2つ目のカテゴリでは、Bea.Tuxedo.Autogen namespaceが使用され、自動生成の.NETクラスがすべて.NETクライアント・ユーティリティでまとめられています。

上記のネームスペースには、「Tuxedo .NET Workstation Client API Reference」に記載された関数に関連付けられたすべてのクラスと構造が含まれています。

AppContextクラス

AppContextクラスは、Tuxedoサービスへのアクセス関数の実行に使用するキー・クラスです。AppContextを使用すると、マルチコンテキスト・クライアント・アプリケーションでOOプログラミング手法を活用できます。

Tuxedo ATMI C関数(たとえば、tpcall()とtpnotify())はほとんどすべてAppContextクラスのメソッドとして定義されています。AppContextクラスのインスタンスの作成は、TuxedoドメインとそのTuxedoドメインで提供される呼出しサービスに接続する上で、重要な要素です。

CまたはCOBOLで記述されたマルチコンテキストのアプリケーションでは、通常、プログラマは2つのATMI関数tpgetctxt()とtpsetctxt()を使用して、Tuxedoコンテキストを切り替える必要があります。この切替えは、Tuxedo .NETワークステーション・クライアントを使用する場合、不要です。クラスAppContextのインスタンスを作成すると、特定のTuxedoコンテキストのインスタンスも作成されます。

特定のAppContextのインスタンスに対する操作は、他のAppContextのインスタンスに影響しません。マルチコンテキスト・アプリケーションを開発し、簡単に切り替えることができます。

Tuxedoコンテキストのインスタンスを作成するには、静的クラスのコンストラクタではなく、メソッドAppContext.tpinit(TPINIT)を呼び出す必要があります。

以下のサンプルは、シングル・コンテキストのTuxedoドメインへの接続方法を表しています。

……

TypedTPINIT  tpinfo = new TypedTPINIT();

AppContext ctx1 = AppContext.tpinit(tpinfo);   // connect to Tuxedo domain

……

ctx1.tpterm();         // disconnect from Tuxedo domain

以下のサンプルは、マルチコンテキストのTuxedoドメインへの接続方法を表しています。

……

TypedTPINIT  tpinfo = new TypedTPINIT();

tpinfo.flags = TypedTPINIT.TPMULTICONTEXTS;   // set multi context flag

// connect to the first Tuxedo domain

AppContext ctx1 = AppContext.tpinit(tpinfo);

Utils.tuxputenv("WSNADDR=//10.2.0.5:1001");

// connect to the second Tuxedo domain

AppContext ctx2 = AppContext.tpinit(tpinfo);

……

ctx1.tpterm();           // disconnect from the first Tuxedo domain

ctx2.tpterm();           // disconnect from the second Tuxedo domain

型付きバッファ

Tuxedo .NETワークステーション・クライアントは、Oracle Tuxedoに組み込まれているバッファ・タイプFML、FML32、VIEW、VIEW32、CARRAY、およびSTRINGをサポートしています。図2は、Tuxedo .NETワークステーション・クライアントの型付きバッファ・クラスの階層を表しています。

Tuxedo .NETワークステーション・クライアントのクラスTypedBufferは、Tuxedoの具体的なバッファ・タイプすべてのベース・クラスであり、低次の関数を派生クラスすべてに継承しています。クラスTypedBufferは抽象クラスであり、インスタンスの作成には使用できません。

STRING型バッファ

Tuxedo .NETワークステーション・クライアントでは、クラスTypedStringを使用して、STRING型バッファの文字を定義します。TypedStringのインスタンスは、tpcall()などのAppContextのメソッドとの通信に直接使用できます。次に使用例を示します。

……

TypedString  snd_str = new TypedString ("Hello World");

TypedString rcv_str = new TypedString(1000);

AppContext ctx = AppContext.tpinit(null);

……

ctx.tpcall("TOUPPER", snd_str, rcv_str, 0);

……

ctx.tpterm();

……

FML/FML32型バッファ

Tuxedo .NETワークステーション・クライアントでは、クラスTypedFML/TypedFML32を使用して、ほとんどのFML C関数を定義します。FML型バッファを使用してTuxedo .NETアプリケーションを開発するには、以下の手順に従います。

FML型バッファのプログラミングの詳細は、『FMLを使用したTuxedo ATMIアプリケーションのプログラミング』を参照してください。

using Bea.Tuxedo.FML;

namespace Bea.Tuxedo.Autogen {

public class fnext_flds {

public static readonly FLDID F_short 	= 110;	// number: 110	 type: short

public static readonly FLDID F_view32	 = 369098863;	// number: 111	 type: view32

    public static readonly FLDID F_double	 = 134217840;	// number: 112	 type: double

    public static readonly FLDID F_ptr	 = 301990001;	// number: 113	 type: ptr

}

}	//	namespace Bea.Tuxedo.Autogen 

……

TypedFML  fmlbuf = new TypedFML(2048);

short s = 123;

fmlbuf.Fadd(fnext_flds.F_short,  s);

……

fmlbuf.Resize(3000);

……

fmlbuf.Dispose();

……

VIEW/VIEW32型バッファ

Tuxedo .NETワークステーション・クライアントでは、クラスTypedVIEWを使用して、VIEW/VIEW32データを作成し、アクセスします。VIEW/VIEW32型バッファを使用してTuxedo .NETワークステーション・クライアント・アプリケーションを開発するには、以下の手順に従います。

型付きバッファ・サンプル・ファイル(Tuxedo .NETワークステーション・クライアント・パッケージに含まれる)は、FMLおよびVIEW型付きバッファの使い方を示します。

Visual Basic (VB)を使用したプログラミング

.NET Framework環境の利点の1つは、言語の統合です。.NETアセンブリが生成されると、.NETでサポートされる言語のどれを使用しても、その.NETアセンブリでアプリケーションを開発できます。そのため、J#、VB、C++など、.NETでサポートされる言語のどれを使用しても、Tuxedo .NETワークステーション・クライアント・アプリケーションを開発できます。

VB言語のサンプル・コードを以下に示します。

Imports System
Imports Bea.Tuxedo.ATMI

Module Main

	Sub Main()
		
		Dim sndstr, rcvstr As TypedString
		Dim ac As AppContext
		Dim info As TypedTPINIT
		
		info = New TypedTPINIT()
		info.cltname = "vb client"
				
		Try 
		    ac = AppContext.tpinit(info)
		
		    sndstr = New TypedString("hello world")
		    rcvstr = new TypedString(1000)
		
		    ac.tpcall("TOUPPER", sndstr, rcvstr, 0)
		
		    Console.WriteLine("rcvstr = {0}"
		 ...rcvstr.GetString(0,1000))
		
		    ac.tpterm()
		
		Catch e as ApplicationException
			
		   Console.WriteLine("Got Exception = {0}", e)
			
		End Try

	End Sub

End Module

.NETワークステーション・クライアントのビルド

buildnetclientユーティリティは、C#ソース・ファイルから.NET実行可能ファイルへのコンパイルを効率化するために、提供されています。「buildnetclient(1)」も参照してください。

buildnetclientの構文例を次に示します。

buildnetclient -v -o simpapp.exe simpapp.cs

エラーの管理

Tuxedo ATMI C関数およびFML C関数で使用されているエラー・コードのリターン・メカニズムは、Tuxedo .NETワークステーション・クライアントの例外メカニズムに置き換えられます。try文を使用すると、Tuxedo .NETワークステーション・クライアントでエラーを処理できます。エラーは2つのカテゴリTPExceptionおよびFExceptionに定義されます。

……

try {

……

      TypedTPINIT  tpinfo = new TypedTPINIT();

      AppContext ctx1 = AppContext.tpinit(tpinfo);   // connect to Tuxedo domain

……

      ctx1.tpterm();         // disconnect from Tuxedo domain

       ……

} catch (ApplicationException e) {

      Console.WriteLine("******Error******, e = {0}", e);

}
……

Tuxedo .NETワークステーション・クライアントのサンプル

Tuxedo .NETワークステーション・クライアント・パッケージには、3つのサンプル・アプリケーションがバンドルされています。

サンプル・アプリケーションにアクセスするには、以下の手順に従います。

関連項目