Workstation コンポーネントの使用

ワークステーション・クライアントのプログラムをコンパイルし、リンクするには、buildclient(1) コマンドを使用します。ネイティブ・ノード (BEA Tuxedo システムがフル・インストールされているノード) でワークステーション・クライアントを作成する場合は、-w オプションを指定し、クライアントの作成にはワークステーション・ライブラリが必要であることを示します。指定しない場合、デフォルトでは、ネイティブ・ノードにあるネイティブ・ライブラリとワークステーション・ライブラリのうち、ネイティブ・ライブラリが使用されます。つまり、-w オプションを指定すると、ワークステーション・クライアントでは正しいライブラリが使用されることが保証されます。ワークステーションには、ワークステーション・ライブラリしかないため、-w オプションを指定する必要はありません。

Windows ディレクトリ	UNIX ディレクトリ	説明
%APPDIR%	$APPDIR	クライアントの実行可能ファイルが格納されています。これらの実行可能ファイルは通常、アプリケーションディレクトリに格納されます。
%TUXDIR%¥bin	$TUXDIR/bin	BEA Tuxedo システムのコマンド群およびシステム・クライアント (wud など) が格納されています
%TUXDIR%¥cobinclude	$TUXDIR/cobinclude	COBOL プログラムで使用する copylib エントリが格納されています。
%TUXDIR%¥include	$TUXDIR/include	BEA Tuxedo システムのヘッダ・ファイル (atmi.h など) が格納されています。
%TUXDIR%¥lib	$TUXDIR/lib	ランタイム・ライブラリが格納されています。
%TUXDIR%¥locale¥C	$TUXDIR/locale/C	デフォルト・ロケールのメッセージ・カタログ (米国の英語) が格納されています
%TUXDIR%¥samples	$TUXDIR/samples	サンプル・アプリケーションのサブディレクトリがいくつか格納されています。

環境変数	説明
TPMBENC	BEA Tuxedo 8.1 以降を実行するワークステーション・マシンが、割り当てられた MBSTRING 型付きバッファに格納するコードセットの符号化名を指定します。ワークステーション・クライアントが MBSTRING バッファを割り当てて送信すると、TPMBENC で定義されたコードセットの符号化名は属性として自動的にバッファに追加され、バッファ・データと共に送信先のサーバ・プロセスに送信されます。ワークステーション・マシンが MBSTRING バッファを受信して、別の環境変数 TPMBACONV が設定されていると見なすと、TPMBENC で定義されたコードセットの符号化名は、受信されたバッファ内のコードセット符号化名と自動的に比較されます。名前が同じではない場合、MBSTRING バッファのデータは、ワークステーション・クライアントに配信される前に、TPMBENC で定義された符号化に自動的に変換されます。 TPMBENC にはデフォルト値はありません。MBSTRING 型付きバッファを使用するワークステーション・クライアントの場合、ワークステーション・マシン上で TPMBENC を定義する必要があります。注記 TPMBENC は FML32 型付きバッファの FLD_MBSTRING フィールドと同じように使用されます。
TPMBACONV	BEA Tuxedo 8.1 以降を実行するワークステーション・マシンが、受信した MBSTRING バッファのデータを、TPMBENC で定義された符号化に自動的に変換するかどうかを指定します。デフォルトでは自動変換は無効になっています。受信した MBSTRING バッファのデータは、符号化の変換はされないままでワークステーション・クライアントに配信されます。TPMBACONV を Y (yes) などの NULL 以外の値に設定すると、自動変換が有効になります。注記 TPMBACONV は FML32 型付きバッファの FLD_MBSTRING フィールドと同じように使用されます。
URLENTITYCACHING	BEA Tuxedo 8.1 以降を実行するワークステーション・マシンが文書型定義 (DTD)、XML スキーマ、およびエンティティ・ファイルをキャッシュするかどうかを指定します。特に、ワークステーション・クライアント上で動作する Apache Xerces-C++ パーサが、検証が必要な場合に DTD と XML スキーマをキャッシュするのか、または DTD で指定された外部エンティティ・ファイルをキャッシュするのかを指定します。デフォルトでは、キャッシングは有効になっています (Y)。URLENTITYCACHING を N (no) に設定すると、キャッシングは無効になります。
URLENTITYCACHEDIR	URLENTITYCACHING=Y (yes) の場合、または設定されていない場合にのみ適用されます。詳細については、この表の URLENTITYCACHING の説明を参照してください。 BEA Tuxedo 8.1 以降を実行するワークステーション・マシンが DTD、スキーマ、およびエンティティ・ファイルをキャッシュするディレクトリを指定します。特に、ワークステーション・クライアント上で動作する Apache Xerces-C++ パーサが、DTD、XML スキーマ、およびエンティティ・ファイルをキャッシュする場所を指定します。URLENTITYCACHEDIR 変数には、キャッシュされるファイルの絶対パス名を指定します。URLENTITYCACHEDIR を指定しない場合、デフォルトのディレクトリは URLEntityCachedir になります。このディレクトリはワークステーション・クライアント・プロセスの現在の作業ディレクトリ内に作成され、適切な書き込み権が設定されています。
WSINTOPPRE71	BEA Tuxedo リリース 7.1 以降を実行しているワークステーション・マシンと、リリース 7.1 より前の BEA Tuxedo アプリケーションを相互運用できるかどうかを指定します。変数を Y に設定すると (WSINTOPPRE71=Y)、相互運用が可能になります。
WSBUFFERS	アプリケーションごとのパケット数。
WSDEVICE	ネットワークのアクセス時に使用するデバイス。この変数は、BEA Tuxedo システムが TLI ネットワーク・インターフェイスを使用している場合のみ必要です。
WSENVFILE	クライアントの環境で使用される環境変数が定義されたファイルの名前。
WSFADDR	ワークステーション・クライアントがワークステーション・リスナまたはワークステーション・ハンドラに接続するのに使用するネットワーク・アドレス。この変数は、WSFRANGE 変数とともに、ワークステーション・クライアントがアウトバウンド接続を行う前にバインドしようとする TCP/IP ポートの範囲を決定します。このアドレスには、TCP/IP アドレスを指定する必要があります。
WSFRANGE	ワークステーション・クライアントのプロセスが、アウトバウンド接続を確立する前にバインドする TCP/IP ポートの範囲。範囲のベースとなるアドレスは、WSFADDR パラメータで指定します。デフォルト値は 1 です。
WSNADDR	ワークステーション・リスナ (WSL) ・プロセスのネットワーク・アドレス。クライアントは、これを使用してアプリケーションにアクセスします。ワークステーション・リスナを呼び出すには、アプリケーションのコンフィギュレーション・ファイルの値を使用してください。「0x」で始まる値は 16 進値を表す文字列と見なされ、それ以外の値は、ASCII 文字列と見なされます。
WSRPLYMAX	ATMI 関数が、アプリケーションからの応答をディスクにダンプする前にバッファに格納するため使用するコア・メモリの最大容量。tpinit(3c) および TPINITIALIZE(3cbl) で使用されます。tpgetrply(3c) および TPGETRPLY(3cbl) で取得した応答および任意通知型メッセージは、この領域に格納されます。この領域がメッセージでいっぱいの場合、オーバーフローしたメッセージはディスク・ファイルに書き込まれます。システムで指定されているデフォルトの最大値は、256,000 バイトです。WSRPLYMAX を使用して低い制限値を設定するかどうかは、マシンの空きメモリに応じて異なります。応答をディスクに書き込むと、パフォーマンスが大幅に低下します。
WSTYPE	ワークステーションの種類。ワークステーション・クライアントによって tpinit(3c) および TPINITIALIZE(3cbl) が呼び出され、ネイティブ・サイトとの間で符号化または復号化を行うかどうかを判断するときに使用されます。WSTYPE を指定しない場合は、ネイティブ・サイトで指定していなくても符号化が行われます。ワークステーションのサイトとネイティブ・サイトには、明示的に同じ WSTYPE を指定し、符号化または復号化の処理が実行されないようにします。

TUXDIR=/opt/tuxedo
[application1]
;これはコメントです
/* これはコメントです */
# これはコメントです
// これはコメントです
set FIELDTBLS=app1_flds
set FLDTBLDIR=/opt/app1/udataobj
[application2]
FIELDTBLS=app2_flds
FLDTBLDIR=/opt/app2/udataobj

tuxreadenv(3c) 関数を呼び出すと、環境ファイルが読み込まれ、プラットフォームに関係なく、プロセス全体の環境に環境変数が追加されます。変数を利用するには tuxgetenv(3c) を使用し、変数をリセットするには、tuxputenv(3c) を使用します。

tpinit(3c) を明示的に呼び出すか、または別の ATMI 関数を呼び出して暗黙的に呼び出すたびに、ワークステーション・クライアントには tuxreadenv(3c) が自動的に呼び出されます。環境に設定されている WSENVFILE は、環境ファイルを示します。設定されていない場合は、tuxreadenv() にファイル名として NULL が渡され、デフォルトのファイルが使用されます。環境に設定されている WSAPP は、環境ファイルのセクションのラベルとして使用されます。設定されていない場合は、tuxreadenv() にラベル名として NULL が渡されます。アプリケーション・クライアントは、tuxreadenv() を明示的に呼び出すこともできます。