イベントチャネルの環境情報の設定について説明します。
イベントチャネルの環境は、essetcnfchnlコマンドを使用して設定します。
イベントチャネルのモデル以外の項目はイベントサービスの構成情報のものと同一です。
グループ全体で設定する項目を以下に示します。
オプション | 内容 | 省略値 | 指定範囲 |
|---|---|---|---|
-edinit | イベントチャネルに蓄積できるイベントデータ数の初期値 | default | 1～10000 |
-edmax | イベントチャネルに蓄積できるイベントデータ数の最大値 | default | 1～10000000 |
-type | イベントサービスのイベントチャネルのモデル | - (none) | push |
ノーティフィケーションサービスのイベントチャネルのモデル | - (none) | mixed | |
-ltime | 蓄積したイベントデータの生存時間（秒） | default | 1～1000000 |
-sthinit | Pushモデルの送信スレッド数の初期値 | default | 1～100 |
-sthmax | Pushモデルの送信スレッド数の最大値 | default | 1～100 |
-coninit | イベントチャネルのグループに接続できるコンシューマ数の初期値 | default | 1～1000 |
-conext | イベントチャネルのグループに接続できるコンシューマの数の拡張数 | default | 1～1000 |
-conenum | イベントチャネルのグループに接続できるコンシューマ数の拡張回数 | default | 1～100 |
-supinit | イベントチャネルのグループに接続できるサプライヤ数の初期値 | default | 1～1000 |
-supext | イベントチャネルのグループに接続できるサプライヤ数の拡張数 | default | 1～1000 |
-supenum | イベントチャネルのグループに接続できるサプライヤ数の拡張回数 | default | 1～100 |
-discon | イベントチャネル終了時のサプライヤ、コンシューマへのdisconnectメソッドの通知 | default | yes,no |
-oneway | Pushモデルでコンシューマがデータを受け取ったことを確認しない | default | yes,no |
-chksend | Pushモデルで通信エラーが発生したコンシューマへの送信迂回 | default | yes,no |
-wtime | Mixedモデルのイベントデータの待ち合わせ時間（秒） | default | 1～1000000 |
-ltrntime | ローカルトランザクションのタイムアウト時間（秒） | default | 1～1000000 |
-pltime | イベントデータおよび接続情報の不揮発チャネル運用時にイベントチャネルに蓄積したイベントデータの生存時間（秒） | default | 1～2000000000 |
-chkcon | コンシューマ未接続時のエラー復帰モード | default | yes,no |
-threshold | 監視蓄積データ率(しきい率) | default | 1～100 |
-safety | 監視再開蓄積データ率 | default | 0～99 |
-blockade | イベントチャネルの閉塞機能を使用する | default | 0,1,2 |
-unblock | 自動閉塞解除率 | default | 0～99 |
-autostart | イベントサービス起動時にイベントチャネルを自動起動する | default | yes, no |
-ptpstop | Point-To-Pointモデルが閉塞終了モードでイベントチャネルの停止時、接続コンシューマ数が0になった時点で停止する | default | yes, no |
イベントチャネルごとに設定する項目を以下に示します。
オプション | 内容 | 省略値 | 指定範囲 |
|---|---|---|---|
-edinit | イベントチャネルに蓄積できるイベントデータ数の初期値 | default | 1～10000 |
-edmax | イベントチャネルに蓄積できるイベントデータ数の最大値 | default | 1～10000000 |
-type | イベントサービスのイベントチャネルのモデル | - | push |
ノーティフィケーションサービスのイベントチャネルのモデル | - | mixed | |
-ltime | 蓄積したイベントデータの生存時間（秒） | default | 1～1000000 |
-discon | イベントチャネル終了時のサプライヤ、コンシューマへのdisconnect通知 | default | yes,no |
-oneway | Pushモデルでコンシューマがデータを受け取ったことを確認しない | default | yes,no |
-chksend | Pushモデルで通信エラーが発生したコンシューマへの送信迂回 | default | yes,no |
-wtime | Mixedモデルのイベントデータの待ち合わせ時間（秒） | default | 1～1000000 |
-ltrntime | ローカルトランザクションのタイムアウト時間（秒） | default | 1～1000000 |
-pltime | イベントデータおよび接続情報の不揮発チャネル運用時にイベントチャネルに蓄積したイベントデータの生存時間（秒） | default | 1～2000000000 |
-chkcon | コンシューマ未接続時のエラー復帰モード | default | yes,no |
-threshold | 監視蓄積データ率(しきい率) | default | 1～100 |
-safety | 監視再開蓄積データ率 | default | 0～99 |
-blockade | イベントチャネルの閉塞機能を使用する | default | 0,1,2 |
-unblock | 自動閉塞解除率 | default | 0～99 |
-ptpstop | Point-To-Pointモデルが閉塞終了モードでイベントチャネルの停止時、接続コンシューマ数が0になった時点で停止する | default | yes, no |
注1）CORBAサービスの動作環境ファイル（config）のperiod_receive_timeoutの値に依存します。
注2）イベントチャネルの蓄積データ数を監視しない場合は、0を指定します。
■環境情報の設定
イベントチャネルのグループ“group”に環境情報を設定するには、以下のように指定します。
例
イベントチャネルに蓄積できるイベントデータ数“10000”、蓄積したイベントデータの生存時間“600”を設定する場合
essetcnfchnl -s -g group -edmax 10000 -ltime 600
注意
すでに不揮発チャネル運用のイベントチャネルが作成されている場合、以下の構成情報は変更できません。その場合、いったんイベントチャネルを削除し、イベントチャネルを再作成してください。
-edmax（イベントチャネルに蓄積できるイベントデータ数の最大値）
-pltime（イベントデータおよび接続情報の不揮発チャネル運用時にイベントチャネルに蓄積したイベントデータの生存時間）
万が一、上記の構成情報を変更した場合、不揮発チャネル運用中のイベントチャネルの動作環境が変更されるため、不揮発化情報の整合性が取れなくなる可能性があります。
■環境情報の表示
イベントチャネルの環境情報を参照するには、essetcnfchnlコマンドに-dオプションを指定します。-dオプションを指定した場合、[イベントチャネルの環境情報の表示例（essetcnfchnl）]の“Point-To-Point model stop mode”までが表示されます。
例
グループ“group”の環境情報を表示する場合
essetcnfchnl -d -g group
ポイント
Interstage Business Application Serverにおいて、-dオプションの表示内容に、Interstage Business Application Serverの情報を付加して表示する場合は、-mcdオプションを指定します。-mcdオプションを指定した場合、[イベントチャネルの環境情報の表示例（essetcnfchnl）]の“Database function”までが表示されます。さらに、“Database function”が“yes”の場合は、“Database host string”までが表示されます。
例
Interstage Business Application Serverの情報を付加してグループ“group”の環境情報を表示する場合
essetcnfchnl -mcd -g group
[イベントチャネルの環境情報の表示例（essetcnfchnl）]
EventService -EventChannel information-
total 1 :group (1)
[00001] channel1 (2)
initial event data :default +
maximum event data :10000 |
type :- |
locale :NONE *1 |
life time (sec) :600 |
maximum connection (mixed) :16 *2 |
initial send thread (push) :default |
maximum send thread (push) :default |
initial connection [consumer] :default |(3)
extra connection [consumer] :default |
extra number [consumer] :default |
initial connection [supplier] :default |
extra connection [supplier] :default |
extra number [supplier] :default |
call disconnect method :yes |
oneway mode (push) :no |
check send status (push) :yes |
auto disconnect mode :no *3 |
Notification channel mode :no *4 |
ssl mode :no *5 |
ots use :no *6 |
persistent mode :no *7 |
unitid :- *8 |
local transaction mode :no *9 |
host name :- *10 |
port number :- *11 |
local tran timeout (sec) :default |
life time (persistent) (sec) :default |
check consumer connection :no |
data cache number :default |
wait time (sec) :default |
Point-To-Point mode :no *12 |
EventChannel blockade function :available *13 |
threshold event data ratio (%) :default |
safety event data ratio (%) :default |
EventChannel blockade level :default |
unblockade event data ratio (%) :default |
EventChannel automatic start :default |
Point-To-Point model stop mode :default |
Database function :yes *14 | +
Database kind :symfo | |
Database name :TESTDB_MSG_ES | |
Database Server IP mode :IPv4 | |(4)
Execution base manager user ID :esuser | |
Database Server IP :192.168.0.1 | |
Database Server port :2050 | |
Database host string :- + +(1) グループ内のイベントチャネル数 (2) イベントチャネル名 (3) イベントチャネルの環境情報 (4) Interstage Business Application Serverのアプリケーション連携実行基盤の構成情報
*1) 静的生成のイベントチャネルのコード系指定
*2) 静的生成のMixedモデルのイベントチャネルグループへのコンシューマ／サプライヤ接続数の合計値
*3) 静的生成のイベントチャネルに対してコネクション情報を自動的に回収する
*4) ノーティフィケーションサービスのイベントチャネルとして生成
*5) 静的生成のイベントチャネルに対してSSL通信を行う
*6) 静的生成のイベントチャネルに対してグローバルトランザクション運用を行う
*7) 静的生成のイベントチャネルに対して不揮発チャネル運用を行う
no : 不揮発チャネル運用を行わない
all:イベントデータ、接続情報が不揮発化の対象となる
con:接続情報だけが不揮発化の対象となる
*8) 静的生成のイベントチャネルに対して不揮発チャネル運用を行う場合のイベントチャネルを作成するユニット
*9) 静的生成のイベントチャネルに対してローカルトランザクション運用を行う
*10)複数IPアドレスを持つシステムにおけるイベントチャネルの通信経路のホスト名
*11)複数IPアドレスを持つシステムにおけるイベントチャネルの通信経路のポート番号
*12)イベントチャネルのメッセージングモデルがPoint-To-Pointモデルである
*13)イベントチャネルの監視機能および閉塞機能が運用可能なイベントチャネルである
*14)Interstage Business Application Serverのアプリケーション連携実行基盤において、メッセージ格納DBを使用してメッセージの不揮発化を行うイベントチャネルである
注）“Database function”が“yes”の場合に、以降のデータベースの内容が表示されます。
*1～*14の情報を設定する場合は、esmkchnlコマンドを使用します。
注意
「*13)イベントチャネルの監視機能および閉塞機能が運用可能である」は、esmkchnlコマンドで直接設定できません。esmkchnlコマンドで以下のようにイベントチャネルを作成した場合に限り、自動的に“available”と表示されます。それ以外の場合は、“unavailable”と表示されます。
「*4) ノーティフィケーションサービスのイベントチャネルとして生成」：“yes”
「*12)イベントチャネルのメッセージングモデルがPoint-To-Pointモデルである」：“yes”
「*6) 静的生成のイベントチャネルに対してグローバルトランザクション運用を行う」／「*9) 静的生成のイベントチャネルに対してローカルトランザクション運用を行う」：“yes”
ポイント
上記の表および表示例の中で省略値がdefaultとなっている場合、essetcnfchnlコマンドで設定されていない項目は、イベントサービスの構成情報の値が適用されます。構成情報の値については、“2.3.1 構成情報の設定”を参照してください。
上記の例の場合、イベントチャネルに蓄積できるイベントデータ数と蓄積したイベントデータの生存時間以外はイベントサービスの構成情報の値がイベントチャネル動作時に適用されます。各項目の設定からイベントチャネル動作時に適用されるまでのデータの伝播の例を以下に示します。
環境の設定項目 | essetcnf設定時 | essetcnfchnl設定時 | 起動時 |
|---|---|---|---|
イベントデータ数の初期値 | 500 | default | 500 |
イベントデータ数の最大値 | 5000 | 10000 | 10000 |
イベントデータの生存時間 | 300 | 600 | 600 |
コンシューマ数の初期値 | 10 | default | 10 |