A.3 essetup

名前

essetup －イベントサービスのセットアップ

形式

essetup [ -f [-p number ] [-m number ] [ -l locale ] [ -autodiscon ] [ -ssl] ]

機能説明

本コマンドは、イベントサービスをシステムにセットアップします。

指定できるオプションとパラメタを以下に示します。

-f: イベントファクトリをセットアップします。イベントサービスがセットアップされていない場合は、併せてイベントサービスをセットアップします。

-p number: イベントファクトリ使用時に、システム上で動作できるイベントチャネルの最大プロセス数を指定します。指定可能な値は、1～256です。本オプションを省略した場合は、“2”が指定されます。

-m number

動的生成のイベントチャネル（Mixedモデル）が動作するプロセスに接続するコンシューマ、サプライヤ数の合計値（最大接続数）を指定します。本設定値は、動的生成のイベントチャネルが動作するすべてのプロセスに対して有効となります。動的生成のイベントチャネルが動作するプロセスの詳細については、「アプリケーション作成ガイド（イベントサービス編）」の「機能」－「イベントチャネルのプロセスとスレッドの構成」を参照してください。

指定可能な値は、1～9999です。本オプションを省略した場合は、“16”が指定されます。

-l locale

日本語データを通信する場合、動的生成のイベントチャネルが動作するマシンのコード系を指定します。

サプライヤとコンシューマが同一のコード系の場合は、指定する必要はありません。ただし、サプライヤ、コンシューマのいずれかがJava言語の場合で、Java言語以外のサプライヤ／コンシューマと接続する場合には、サプライヤ／コンシューマが動作するマシンのコード系が同じ場合でもイベントチャネルのコード系を設定してください。

指定可能なコード系は、以下のとおりです。

指定値	コード系
SJIS	ShiftJIS
EUC	EUC
UNICODE	UNICODE
UTF8	UTF8

-autodiscon

本オプションを指定すると、アプリケーションの異常終了などにより、サプライヤ・コンシューマが動的生成のイベントチャネルに対してdisconnectメソッドを発行しないで終了した場合、イベントチャネルに残ったコネクション情報を自動回収する処理が有効となります。本オプションを指定しない場合は、無効となります。

また、コネクション情報の自動回収時にトランザクション中のローカルトランザクション（未完了のローカルトランザクション）が存在した場合、ローカルトランザクションをロールバックします。

ただし、以下の運用を行っている場合は、本オプションを指定しないでください。

サプライヤ／コンシューマのオブジェクトリファレンスをファイル／ネーミングサービスに保存している。かつ、
サプライヤ／コンシューマの再起動時、イベントチャネルに再接続しない。かつ、
ファイル／ネーミングサービスに保存したオブジェクトリファレンスを使用して送受信処理を行っている。

なお、本オプションを指定した場合、CORBAサービスのクライアント側無通信監視時間超過によりコネクションが切断される可能性があります。継続して通信する場合は、イベントチャネルへの接続から行ってください。

-ssl: 本オプションを指定すると、動的生成のイベントチャネルでSSL通信を行います。SSL通信については、“セキュリティシステム運用ガイド”の“CORBAサービスでSSLを利用する方法”を参照してください。

注意事項

本コマンドは、管理者権限で実行してください。
ismodifyserviceコマンドを使用してInterstage運用環境にイベントサービスを追加し、Interstage統合コマンドによる運用操作を行う場合は、本コマンドを使用しないでください。ismodifyserviceコマンドについては、“2.4 ismodifyservice”を参照してください。
Interstage管理コンソールを使用してイベントサービスを“使用する”と設定し、Interstage管理コンソールによる運用操作を行う場合は、本コマンドを使用しないでください。Interstage管理コンソールによる運用操作手順については、Interstage管理コンソールのヘルプを参照してください。
Usageに[-M system]が表示されますが、[-M system]は指定できません。

使用例

イベントチャネルのプロセス数“4”、コンシューマ、サプライヤの最大接続数“50”を設定し、コネクション情報の自動回収を有効とするイベントファクトリをセットアップします。イベントサービスがセットアップされていない場合は、イベントサービスも同時にセットアップします。

essetup -f -p 4 -m 50 -autodiscon