ワークステーション・クライアントの設定

ワークステーション・クライアントをOracle Tuxedoアプリケーションに参加させるには、対応するアプリケーション環境が必要です。Oracle Tuxedoシステムには、表14-1に示すような、環境設定用の変数が用意されています。TUXDIRおよびWSNADDRは必須の変数であり、それ以外は省略可能な変数です。WSENVFILE以外のパラメータには、デフォルト値が用意されています。

表14-1 ワークステーション・クライアントの定義
次を指定するには. . .	この環境変数を設定します. . .
アプリケーション・パスワード。(パスワードによるセキュリティ機能を実装するアプリケーションでのみ有効です。)スクリプトから実行するクライアントは、この変数を使用してアプリケーション・パスワードを取得できます。	`APP_PW` (オプション)
SSLの開始時に認証に使用するためのセキュリティ・プリンシパル名の識別文字列を指定します。このパラメータには、最後のNULL文字を除いて最大511文字まで指定できます。	`SEC_PRINCIPAL_NAME` (オプション)
`SEC_PRINCIPAL_NAME`で指定されたプリンシパルの復号化(プライベート)キーを収めるファイルまたはデバイスの場所を指定します。このパラメータには、最後のNULL文字を除いて最大1023文字まで指定できます。	`SEC_PRINCIPAL_LOCATION` (オプション)
`SEC_PRINCIPAL_NAME`で指定されたプリンシパルのパスワードが格納される変数を指定します。このパラメータには、最後のNULL文字を除いて最大31文字まで指定できます。	`SEC_PRINCIPAL_PASSWORD` (オプション)
リンク・レベルの暗号化に使用する暗号化キーの最上位ビットの最大数。設定できる値は、0(暗号を使用しない場合)か、40、56、128、または256(指定された番号が暗号化キーの最上位ビット数の場合)です。	`TMMAXENCRYPTBITS` (オプション)
リンク・レベルの暗号化に使用する暗号化キーの最上位ビットの最小数。設定できる値は、0(暗号を使用しない場合)か、40、56、128、または256(指定された番号が暗号化キーの最上位ビット数の場合)です。	`TMMINENCRYPTBITS` (オプション)
`WSRPLYMAX`値に達した場合に応答を格納するディレクトリ。デフォルトは作業ディレクトリです。	`TMPDIR` (オプション)
ワークステーション・マシンが、割り当てられたMBSTRING型付きバッファに格納するコードセットのエンコーディング名を指定します。 `TPMBENC`のデフォルト値はありません。MBSTRING型付きバッファを使用するワークステーション・クライアントの場合、ワークステーション・マシン上で`TPMBENC`を定義する必要があります。	`TPMBENC` (オプション)
ワークステーション・マシンが、受信したMBSTRINGバッファのデータを、`TPMBENC`で定義されたエンコードに自動的に変換するかどうかを指定します。デフォルトでは自動変換は無効になっています。つまり、受信したMBSTRINGバッファのデータは、そのまま(エンコーディングの変換なしに)ワークステーション・クライアントに配信されます。`TPMBACONV`を`Y` (yes)などの値に設定すると、自動変換が有効になります。	`TPMBACONV` (オプション)
このワークステーション上でのOracle Tuxedoシステム・ソフトウェアの場所。この環境変数を設定しないと、クライアントは接続を確立できません。	`TUXDIR` (必須)
ワークステーション・マシンがドキュメント型定義(DTD)、XMLスキーマ、およびエンティティ・ファイルをキャッシュするかどうかを指定します。デフォルトでは、キャッシングは有効になっています(`Y`)。`URLENTITYCACHING`を`N` (no)に設定すると、キャッシングは無効になります。	`URLENTITYCACHING` (オプション)
ワークステーション・マシンがDTD、スキーマ、およびエンティティ・ファイルをキャッシュするディレクトリを指定します。`URLENTITYCACHEDIR`変数には、キャッシュするファイルの絶対パス名を指定します。`URLENTITYCACHEDIR`を指定しない場合、デフォルトのディレクトリは`URLEntityCachedir`になります。このディレクトリはワークステーション・クライアント・プロセスの現在の作業ディレクトリ内に作成され、適切な書込み権が設定されています。	`URLENTITYCACHEDIR` (オプション)
使用するネットワーク・デバイス。デフォルトは空文字列です。	`WSDEVICE` (オプション)
すべての環境変数を設定するファイルの名前。この変数のデフォルト値はありません。	`WSENVFILE` (オプション)
ワークステーション・クライアントがワークステーション・リスナーまたはワークステーション・ハンドラに接続するのに使用するネットワーク・アドレス。この変数および`WSFRANGE`環境変数は、TCP/IPポート(ワークステーション・クライアントがアウトバウンド接続を行う前にバインドするときのバインド先)の範囲を指定します。このアドレスは、TCP/IPアドレスでなければなりません。	`WSFADDR` (オプション)
ワークステーション・クライアントのプロセスが、アウトバウンド接続を確立する前にバインドするTCP/IPポートの範囲。範囲のベースとなるアドレスは、`WSFADDR`パラメータで指定します。	`WSFRANGE` (オプション)
クライアントがコンタクトするWSLの1つまたは複数のネットワーク・アドレスのリスト。このアドレスは、アプリケーション構成ファイルにあるWSLプロセスのアドレスと一致する必要があります。	`WSNADDR` (必須)
アプリケーションの応答を一時的に保存するためのコア・メモリーのサイズ。デフォルトは256,000バイトです。	`WSRPLYMAX` (オプション)
マシンのタイプ。WSLが動作するマシンの構成ファイルで指定されている`TYPE`の値と同じ値を`WSTYPE`に指定すると、エンコード/デコードは行われません。デフォルトは空文字列です。	`WSTYPE` (オプション)

ワークステーション・クライアントの最大数の設定

アプリケーションにワークステーション・クライアントを参加させるには、UBBCONFIGファイルのMACHINESセクションでMAXWSCLIENTSパラメータを指定する必要があります。

MAXWSCLIENTSは、Workstation機能専用の唯一のパラメータです。MAXWSCLIENTSに指定された値は、Oracle Tuxedoシステムの起動時に通知され、ワークステーション・クライアント用に確保するアクセサ・スロットの数が決まります。ネイティブ・クライアントの場合、各アクセサ・スロットに必要なセマフォは1つです。一方、ワークステーション・ハンドラ・プロセス(ワークステーション・クライアントのかわりにネイティブ・プラットフォーム上で実行するプロセス)は、ワークステーション・クライアントのアクセスを単一のアクセサ・スロットに多重化するので、必要なセマフォは1つだけです。この点も、Workstationコンポーネントの利点の1つです。多くのクライアントをネイティブ・プラットフォームからワークステーションに移動することによって、アプリケーションで使用するIPCリソースを減らすことができます。

MAXWSCLIENTSは、MAXACCESSERSに指定された数のうち、指定された数のアクセサ・スロットを使用します。MAXWSCLIENTSの設定時には、ネイティブ・クライアントとサーバーを収容するために必要な数のスロットを残しておく必要があります。MAXWSCLIENTS値がMAXACCESSERS値を超えると、tpinit()の実行時にネイティブ・クライアントとサーバーが失敗します。次の表は、MAXWSCLIENTSパラメータの説明です。

パラメータ	説明
`MAXWSCLIENTS`	マシンに接続するWSCの最大数を指定します。構文は`MAXWSCLIENTS=number`です。デフォルトは0です。 `MAXWSCLIENTS`を指定しないと、WSCは指定されたマシンに接続できません。

ワークステーション・リスナー(WSL)のサーバーとしての定義

ワークステーション・クライアントがアプリケーションにアクセスするときは、1つのWSLプロセスと1つ以上のWSHプロセスのサービスが介在します。WSLは、複数のワークステーション・クライアントをサポートできます。つまり、すべてのワークステーション・クライアントは、WSLのコマンド行で指定される同一のネットワーク・アドレスでアプリケーションと接続します。リスナーは、1つまたは複数のワークステーション・ハンドラ・プロセスをスケジューリングします。

WSHプロセスは、アプリケーションの管理ドメインで、リモート・ワークステーション上のクライアントの代理として機能します。WSHは多重化スキームによって、複数のワークステーション・クライアントを同時にサポートします。

アプリケーションにワークステーション・クライアントを参加させるには、UBBCONFIGファイルのSERVERSセクションにワークステーション・リスナー(WSL)のプロセスを指定する必要があります。サーバーを指定する場合と同じ構文を使用してください。

WSLプロセスに対する情報の指定

WSLプロセスに情報を渡すには、コマンド行オプション文字列(CLOPT)を使用します。CLOPTパラメータの形式は、次のとおりです。

CLOPT="[ -A ] [servopts_options] -- -n netaddr [-d device]
       [-w WSHname][-t timeout_factor][-T Client_timeout]
	[-m minh][-M maxh][-x mpx_factor ]
       [-p minwshport][-P maxwshport]
       [-I init_timeout][-c compression_threshold]
       [-k compression_threshold]
       [-z bits][-Z bits][-H external_netaddr]
       [-N network_timeout][-K{client|handler|both|none}]"

-Aオプションを指定すると、WSLは起動時にすべてのサービスを提供します。デフォルトでは、このオプションが用意されていますが、ここでは、システム提供のサーバーとアプリケーション・サーバーの違いを強調するために示してあります。アプリケーション・サーバーの起動時には、利用可能なサービスのサブセットだけが提供される場合もあります。

二重ダッシュ(--)は、起動後にWSLに渡されるパラメータ・リストの開始位置を示します。

CLOPTでのコマンド行オプションの使用

表14-2に示すコマンド行オプションは、CLOPT文字列の二重ダッシュ(--)の後に指定できます。

表14-2 CLOPTでのコマンド行オプション・セットの使用
このコマンド行オプションを使用します. . .	次を指定するには. . .
`-n` `netaddr` (必須)	WSCがリスナーに接続するためのネットワーク・アドレス。WSCは、`-n`の後に指定されている値に対し、適切な環境変数(`WSNADDR`)を設定する必要があります。
[`-d` `device`] (一部のトランスポート・インタフェースでは必須)	ネットワーク・デバイス名。これは、一部のトランスポート・インタフェースでのみ必要な省略可能なパラメータです。たとえば、ソケットではこのパラメータは必要ありません。
[`-t` `timeout`]	クライアントがWSHに接続するまでの時間。システムはtimeoutの値と`SCANUNIT`パラメータの値を乗算して、接続までの時間を算出します。デフォルトは、セキュリティなしのアプリケーションでは3、セキュリティ付きアプリケーションでは6です。このコンテキストでは、次のいずれかのパラメータが設定されているアプリケーションは、セキュリティ付きであると見なされます。 `USER_AUTH` `ACL` `MANDATORY_ACL` `APP_PW`
[`-w` `name`]	このリスナーに対して起動するWSHプロセスの名前。デフォルトは`WSH`、つまり提供されているハンドラの名前です。`buildwsh(1)`コマンドで別のハンドラ・プロセスを作成した場合は、その名前をここで指定します。
[`-m` `number`]	起動し、常に利用可能にしておくハンドラの最小数。デフォルトは0です。
[`-M` `number`]	起動できるハンドラの最大数。デフォルトは、マシンの`MAXWSCLIENTS`を多重係数(`-x`で指定)で割った値です。
[`-x` `number`]	WSHが同時に多重化できるクライアントの最大数。この値は0より大きくなければなりません。デフォルトは10です。
[-T `client_timeout`]	クライアントが、接続を切断されないままアイドル状態でいられる時間(分)。クライアントがこの時間内にリクエストを行わなかった場合、WSHはクライアント接続を切断します。この引数を指定しない場合、または0が指定されている場合、タイムアウトは発生しません。
[`-p` `minwshport`]および[`-P` `maxwshport`]	このリスナー・サーバーに関連付けられているWSHが使用できるポート番号の範囲。0 - 65535の範囲のポート番号を指定してください。デフォルトは、`minwshport`が2048、`maxwshport`が65535です。
[`-z`]および[`-Z`]	WSL側で、リンク・レベルの暗号化のために使用できるビットの範囲。ビットの最小値を指定するには`-z`を使用し、最大値を指定するには`-Z`を指定します。
[`-N` `network_timeout`]	ワークステーション・クライアントがWSL/WSHからのレスポンスを受け取るまでの最小待機時間(秒)。デフォルト値は0、つまりタイムアウトが発生しないことを示します。
[`-K` {`client` \| `handler` \| `both` \| `none`}]	ワークステーション・ハンドラとワークステーション・クライアントの間で、指定された時間内にトラフィックが発生しなかった場合、これらの間で接続を確立するかどうか。

関連項目

ネットワーク障害の検出

Workstationコンポーネントには、ネットワーク接続が切断されてもハング状態が無期限に続かないようにするための、WSL用の管理オプションが用意されています。これにより、次のことを実現できます。

keep-aliveオプションの使用

keep-aliveは、ワークステーション・ハンドラとワークステーション・クライアントの間で一定期間トラフィックが発生しなかった場合に、その接続の実行可能性を定期的にチェックするネットワーク機能です。

keep-aliveオプションをリクエストするには、UBBCONFIGファイルのSERVERSセクションで、WSL CLOPTエントリに-Kオプションを追加します。-Kオプションは、client、handler、both、またはnoneという引数を取ります。

表14-3 keep-aliveオプションの使用
このオプションを使用します...	次を行うには...
`-K client`	クライアント・マシンからkeep-aliveメッセージを生成します。keep-aliveメッセージが認識されない場合、クライアント・マシンはネットワークがダウンしていると見なします。以降のATMI呼出しは、`TPESYSTEM`の`tperrno`で異常終了します。
`-K handler`	ハンドラ・マシンからkeep-aliveメッセージを生成します。keep-aliveメッセージが認識されない場合、ハンドラ・マシンはネットワークがダウンしているものとみなします。ハンドラは、応答しないクライアントに関連するエントリをクリーンアップします。この結果、ワークステーションが同時に多重化できるクライアント(`-x`で指定)を、ハンドラが消費しないようにすることができます。
`-K both`	クライアント・マシンとハンドラ・マシンの両方から、keep-aliveメッセージを生成します。このコンポーネントの利用度とタイムアウトのしきい値は、オペレーティング・システムの調整可能なパラメータによって決まります。
`-K none`	keep-aliveオプションをオフにします。この設定は、`-K`をまったく指定しない場合と同じ結果になります。

WSL SRVGRP="WSLGRP" SRVID=1000 RESTART=Y GRACE=0
CLOPT="-A -- -n //ws.beasys.com:5120 -d /dev/tcp -K both"

この例では、-Kにより、ワークステーション・クライアントとワークステーション・サーバーの両方のkeep-aliveチェックが有効になります。

UBBCONFIGのWSLエントリの詳細は、『ファイル形式、データ記述、MIBおよびシステム・プロセス・リファレンス』の「WSL(5)」を参照してください。

keep-aliveオプションの制約

keep-aliveオプションは、ソケットを使用するOracle Tuxedoシステムを搭載したプラットフォームでのみサポートされます。

このオプションは、上記以外のプラットフォームでは使用できません。Oracle Tuxedoシステムでは、どのサーバー・マシンにも-Kオプションを指定できますが、上記以外のプラットフォームでは正しく実行されません。上記以外のプラットフォームでkeep-alive機能を実行すると失敗し、ユーザー・ログにメッセージが書き込まれます(WSHのプロセスごとに1回)。処理は、通常どおり続行します。

ネットワーク・タイムアウト・オプションの使用

ネットワーク・タイムアウトとは、ワークステーション・クライアントによる操作を待機する時間を指定するオプションです。ここで指定した時間を経過すると、操作に対するリクエストは、ネットワーク上で取消し(タイムアウト)されます。

ネットワーク・タイムアウトは、WSLの管理オプションである-Nを使用してリクエストできます。-Nオプションは、ネットワーク・タイムアウトを使用して、ワークステーション・クライアントのデータを受信します。

ネットワーク・タイムアウトのしくみ

ネットワーク・タイムアウト・オプションにより、ワークステーション・クライアントがネットワークからデータを受信するためのOracle Tuxedo操作を待機する期間(秒単位)が指定されます。この期間を過ぎると、操作は失敗し、クライアントはアプリケーションから切断されます。値0(デフォルト)はタイムアウトが発生しないことを示します。

タイムアウトが発生すると、各ATMI関数はエラーを返します。リンクでタイムアウトが発生すると、アプリケーションに通知されます。この場合、既存のエラー・コードが使用されます。(特定のエラー・コードの詳細については、tperrordetail(3c)を呼び出して参照してください。)ネットワーク・タイムアウトが発生すると、未処理の操作は信頼できないステータスになります。つまり、トランザクションが途中で終了したり、応答が失われたりします。アプリケーションへの接続を安全に終了するには、WSHと通信せずに、tpterm(3c)の呼出しと同じ操作を行います。

操作が返される時点では、クライアントはOracle Tuxedoアプリケーションの一部ではなくなっています。クライアントを再度アプリケーションに参加させるには、次のどちらかの方法を使用します。

ネットワーク・タイムアウト・オプションの制限

ネットワーク・タイムアウト・オプションの設定

Oracle Tuxedoアプリケーションにネットワーク・タイムアウト・オプションを指定するには、WSL CLOPTの引数に-Nオプションを追加します。

ワークステーション・クライアントをサポートする構成ファイルの例

リスト14-1のサンプル構成ファイルからの次の抜粋は、bankappアプリケーションにワークステーション・コンポーネントを追加する方法を示しています。ここでは、MACHINESセクションとSERVERSセクションが変更されています。

MACHINESセクションおよびSERVERSセクションの変更

MACHINESセクションおよびSERVERSセクションが次のように変更されています。

MACHINESセクションでは、MAXWSCLIENTSのデフォルト値が2つのサイトのエントリでオーバーライドされています。SITE1ではデフォルト値が150に引き上げられ、SITE2では0に引き下げられています。値0の場合は、ワークステーションが接続されません。
SERVERSセクションでは、WSLプロセスはグループBANKB1に指定されています。WSLのサーバーIDは500です。再起動可能と指定されています。
コマンド行オプションでは、以下の値が指定されています。

WSLはすべてのサービスを通知します(-A)。
WSLはネットワーク・アドレス//ws.beasys.com:5120でリスニングします(-n)。
最低5つのWSHが起動します(-m)。
最大30のWSHが起動します(-M)。
各ハンドラは同時に最大5つのクライアントを接続できます(-x)。

Oracle Tuxedoアプリケーションの設定