Interstage Application Server リファレンスマニュアル（コマンド編）

10.2 esmkchnl

名前

　esmkchnl　−　イベントチャネルの作成

形式

(1) イベントチャネルの生成（イベントサービスの場合）
　esmkchnl -g group -c channel ... [-m number] [-l locale] [-autodiscon]
　　　　　[-ssl] [-w] [-host HostName -port PortNum] [-M system]

(2) イベントチャネルの生成（ノーティフィケーションサービス／JMSの場合）
　esmkchnl -g group -c channel ... [-m number] [-l locale] [-autodiscon]
　　　　　[-ssl] [-w] [-host HostName -port PortNum] [-M system]
　　　　　-notify [-persist mode] [-unit unitid] [-tran | -ots] [-ptp]

機能説明

　イベントチャネル（静的生成運用）を作成します。イベントチャネルの作成は1つ以上のイベントチャネルにグループ名を付けて作成します。
　指定できるオプションとパラメタを以下に示します。

［イベントサービス／ノーティフィケーションサービス／JMS共通オプション］

-g group

　グループ名を指定します。
　揮発チャネルを作成する場合は64文字以内の文字列で、不揮発チャネル（-persistオプションと同時指定）を作成する場合は、32文字以内の文字列で指定します。
　JMSの機能を使用するイベントチャネルを作成する場合、英数字および以下の記号を含めた文字列（先頭は英数字）を使用することができます。

• ハイフン(-)
• ピリオド(.)
• スラッシュ(/)
• アンダースコア(_)

　上記以外の記号を含めた文字列を設定した場合、Interstage管理コンソールの[システム] > [サービス] > [JMS] > [イベントチャネル] > [状態]で表示されるイベントチャネルの一覧には表示されません。

-c channel

　グループに含まれるイベントチャネル名を、64文字以内の文字列で指定します。複数指定が可能です。
　JMSの機能を使用するイベントチャネルを作成する場合、英数字および以下の記号を含めた文字列（先頭は英数字）を使用することができます。

• ハイフン(-)
• ピリオド(.)
• スラッシュ(/)
• アンダースコア(_)

　上記以外の記号を含めた文字列を設定した場合、Interstage管理コンソールの[システム] > [サービス] > [JMS] > [イベントチャネル] > [状態]で表示されるイベントチャネルの一覧には表示されません。

-m number

　グループに含まれるMixedモデルのイベントチャネルに接続するサプライヤ、コンシューマの合計値（最大接続数）を指定します。本オプションを省略した場合は、16が指定されます。

-l locale

　日本語データを通信する場合に指定する必要があります。イベントチャネルが動作するマシンのコード系を指定します。EUCの場合は“EUC”を、ShiftJISの場合は“SJIS”を指定します。
　サプライヤとコンシューマが同一のコード系の場合は指定する必要はありません。ただし、サプライヤ、コンシューマが共にJava言語の場合は、イベントチャネルのコード系を設定する必要があります。

　Linuxシステムでは、指定可能なコード系は“EUC”のみです。

-autodiscon

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

-ssl

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

-w

　クラスタサービス機能の運用で待機系サーバのセットアップを行う場合に指定します。本オプションを指定する場合、ネーミングサービスにイベントチャネルのオブジェクトリファレンスを登録しません。また、不揮発化運用を行う場合は、ユニットにデータ格納領域を作成しません。

-host HostName

　複数IPアドレスを持つシステムで、イベントチャネルの通信経路であるホスト名（またはIPアドレス）を指定します。
　ただし、Interstage動作環境定義で"Corba Host Name"を設定（またはconfigファイル(CORBAサービス)の"IIOP_hostname"：CORBAサービスが使用するホスト名を特定）している場合は、本オプションは指定しないでください。（本オプションで"Corba Host Name"以外のホスト名を指定すると、イベントチャネルの起動に失敗します。）
　なお、本オプションを省略すると、"Corba Host Name"設定時は"Corba Host Name"のホスト名、未設定時には主系のホスト名が使用されます。

-port PortNum

　複数IPアドレスを持つシステムで、イベントチャネルの通信経路であるポート番号を指定します。
　CORBAサービスのポート番号として指定されている以下のどちらかを指定してください。

• -sslオプション未指定時
  　Interstage動作環境定義の"Corba Port Number"（configファイル(CORBAサービス)の"IIOP_port"）
• -sslオプション指定時（SSL通信時）
  　Interstage動作環境定義の"SSL Port Number"（configファイルの"UNO_IIOP_ssl_port"）

-M system

　拡張システムを生成した場合に、運用の対象となるシステム名systemを指定します。本オプションを省略すると、デフォルトシステムでの運用が対象となります。
　本オプションは、以下の製品で指定可能です。
　−　Interstage Application Server Enterprise Edition

［ノーティフィケーションサービス／JMS用オプション］

-notify

　本オプションを指定した場合、ノーティフィケーションサービス／JMSのイベントチャネルとして生成します。ノーティフィケーションサービス／JMSの機能を使用するイベントチャネルを作成する場合に指定します。指定しない場合はノーティフィケーションサービス／JMSの機能は使用できません。

-persist mode

　作成するイベントチャネルで不揮発化運用を行う場合に指定します。JMSでは、Durable Subscription機能、イベントチャネルの不揮発化機能、ローカルトランザクション機能およびグローバルトランザクション機能を使用する場合に指定します。指定可能なモードmodeは、以下のとおりです。
　all：イベントデータ、接続情報が不揮発化の対象となります（JMSではallのみ指定可能）。
　con：接続情報のみが不揮発化の対象となります。

　本オプションを指定する場合は、あらかじめ、esmkunitコマンドを使用してユニットを作成する必要があります。
　また、本オプションは-notifyオプションを同時に指定する必要があります。

-unit unitid

　不揮発化運用を行う場合のイベントチャネルを作成するユニットを指定します。-persistオプションを指定し、かつ本オプションを指定しない場合は、標準ユニットにイベントチャネルを作成します。

-tran

　作成するイベントチャネルで、ローカルトランザクション運用を行う場合に指定します。サーバ間連携を行う場合、およびJMSにおいてグローバルトランザクション運用を行わない場合は、本オプションを指定する必要があります。

-ots

　作成するイベントチャネルで、グローバルトランザクション運用を行う場合に指定します。本オプションは、1つのユニットに対して1つのみのイベントチャネルグループを作成できます。なお、イベントチャネルグループ内には複数のチャネルを作成することができます。また、標準ユニットには作成することができません。
　本オプションは、-persistオプションに“all”が指定されている場合に有効です。
　グローバルトランザクション運用については、“OLTPサーバ運用ガイド”（Enterprise EditionおよびStandard Editionで提供）の“リソース管理プログラムの運用”で説明されています。

-ptp

　メッセージングモデルをPoint-To-Pointモデルとして、イベントチャネルを作成します。本オプションを省略した場合は、ノーティフィケーションサービスではメッセージングモデルをMultiCastモデルとして、JMSではメッセージングモデルをPublish/Subscribeモデルとしてイベントチャネルを作成します。
　本オプションは、-notifyオプションを同時に指定する必要があります。さらに、不揮発化運用時（共に-persistオプションを指定した場合）は、Point-To-Pointモデルではトランザクション運用を行う必要があるため、-tranオプションまたは-otsオプションを同時に指定する必要があります。
　ノーティフィケーションサービスのメッセージングモデルの詳細については、“アプリケーション作成ガイド（イベントサービス編）”（Enterprise EditionおよびStandard Editionで提供）の“基礎知識”−“メッセージングモデル”を参照してください。

注意事項

• 本コマンドは、管理者権限で実行してください。
• ネーミングサービスが起動されている必要があります。
• 本コマンドによりイベントチャネルを作成後、Interstageの初期化を行う場合は、初期化前にesrmchnlコマンドにより作成したイベントチャネルを削除してください。
  また、イベントチャネルを削除せずにInterstageの初期化を行った場合は、esrmchnlコマンドにより初期化前に作成したイベントチャネルを削除する必要があります。
  なお、作成したイベントチャネルの一覧は、essetcnfchnlコマンドの-lオプションを使用して確認してください。
• 不揮発化運用を行う場合は、イベントサービスが起動されている必要があります。
• -gオプションのイベントチャネルグループ名、または-cオプションのイベントチャネル名に、以下の文字以外を含めて設定した場合、Interstage管理コンソールを使用してイベントチャネルの一覧を表示すると、エラーメッセージ“es39996”または“es39999”が出力され操作することができません。Interstage管理コンソールを使用する場合、イベントチャネルグループ名およびイベントチャネル名には、以下の文字を使用してください。なお、ハイフン(-)は先頭文字に使用することができません。

  	Interstage管理コンソールで使用可能な文字
  イベントチャネルグループ名	英数字、イクスクラメーションマーク(!)、ナンバー(#)、ドルマーク($)、アポストロフィー(')、左丸括弧(()、右丸括弧())、プラス(+)、ハイフン(-)、ピリオド(.)、スラッシュ(/)、セミコロン(;)、アットマーク(@)、左角括弧([)、右角括弧(])、アンダースコア(_)、逆クォート(`)、左中括弧({)、右中括弧(})、波線(~)
  	英数字、イクスクラメーションマーク(!)、プラス(+)、ハイフン(-)、ピリオド(.)、スラッシュ(/)、アットマーク(@)、左角括弧([)、右角括弧(])、アンダースコア(_)、左中括弧({)、右中括弧(})、波線(~)
  	英数字、プラス(+)、ハイフン(-)、ピリオド(.)、スラッシュ(/)、アットマーク(@)、左角括弧([)、右角括弧(])、キャロット(^)、アンダースコア(_)、左中括弧({)、右中括弧(})
  イベントチャネル名	英数字、イクスクラメーションマーク(!)、ナンバー(#)、ドルマーク($)、アポストロフィー(')、左丸括弧(()、右丸括弧())、アスタリスク(*)、プラス(+)、カンマ(,)、ハイフン(-)、ピリオド(.)、スラッシュ(/)、コロン(:)、セミコロン(;)、イコール(=)、クエスチョンマーク(?)、アットマーク(@)、左角括弧([)、右角括弧(])、アンダースコア(_)、逆クォート(`)、左中括弧({)、右中括弧(})、波線(~)
  	英数字、イクスクラメーションマーク(!)、アスタリスク(*)、プラス(+)、カンマ(,)、ハイフン(-)、ピリオド(.)、スラッシュ(/)、コロン(:)、イコール(=)、クエスチョンマーク(?)、アットマーク(@)、左角括弧([)、右角括弧(])、アンダースコア(_)、左中括弧({)、右中括弧(})、波線(~)
  	英数字、パーセント(%)、アスタリスク(*)、プラス(+)、カンマ(,)、ハイフン(-)、ピリオド(.)、スラッシュ(/)、コロン(:)、イコール(=)、クエスチョンマーク(?)、アットマーク(@)、左角括弧([)、右角括弧(])、キャロット(^)、アンダースコア(_)、左中括弧({)、右中括弧(})

• -persist, -unit, -tran, -ots, -ptpオプションには、他のオプションと依存関係／排他関係があります。以下の表を参考にして指定してください。
  例えば、-persistオプションは、-notifyオプションと同時に指定する必要がありますが、-autodisconオプションと同時に指定することはできません。

  オプション	依存オプション	排他オプション
  -persist	-notify	-autodiscon
  -unit	-notify　-persist	-autodiscon
  -tran	-notify	-autodiscon　-ots
  -ots	-notify　-persist(allのみ)	-autodiscon　-tran
  -ptp	-notify	なし
  -persist　-ptp	-notify　-tran または -notify　-ots	-autodiscon

• イベントチャネルの閉塞機能を使用する場合、-notify -tran -ptpオプション、または-notify -ots -persist all -ptpオプションを指定してイベントチャネルを生成する必要があります。

使用例

　グループ名“EVENT1”、サプライヤ、コンシューマの最大接続数“100”のイベントサービスのイベントチャネル“CHNL1”、“CHNL2”を作成します。

esmkchnl -g EVENT1 -c CHNL1 CHNL2 -m 100

　グループ名“EVENT2”、サプライヤ、コンシューマの最大接続数“100”のノーティフィケーションサービス／JMSのイベントチャネル“CHNL3”、“CHNL4”を作成します。

esmkchnl -g EVENT2 -c CHNL3 CHNL4 -m 100 -notify

　不揮発化運用、およびローカルトランザクション運用を行うイベントチャネル“CHNL5”を作成します。

esmkchnl -g EVENT3 -c CHNL5 -notify -persist all -tran

　メッセージングモデルをPoint-To-Pointモデルとして、不揮発化運用およびローカルトランザクション運用を行うイベントチャネル“CHNL6”を作成します。

esmkchnl -g EVENT4 -c CHNL6 -notify -persist all -tran -ptp

　コード系“SJIS”のイベントサービスのイベントチャネル“CHNL7”を作成します。

esmkchnl -g EVENT5 -c CHNL7 -l SJIS

　コード系“SJIS”のノーティフィケーションサービス／JMSのイベントチャネル“CHNL8”を作成します。

esmkchnl -g EVENT6 -c CHNL8 -l SJIS -notify

　コード系“EUC”のイベントサービスのイベントチャネル“CHNL9”を作成します。

esmkchnl -g EVENT7 -c CHNL9 -l EUC

　コード系“EUC”のノーティフィケーションサービス／JMSのイベントチャネル“CHNL10”を作成します。

esmkchnl -g EVENT8 -c CHNL10 -l EUC -notify

　イベントチャネルの閉塞機能を使用するため、以下のようなノーティフィケーションサービス／JMSのイベントチャネルを作成します。
　−　グループ名：EVENT9
　−　イベントチャネル名：CHNL11
　−　ローカルトランザクション運用を行う
　−　メッセージングモデル：Point-To-Pointモデル

esmkchnl -g EVENT9 -c CHNL11 -notify -tran -ptp