MessageQueueDirector説明書

4.3.3.1 サービス定義の記述

　サービス定義は、メッセージの送受信で使用するイベントチャネルに関する各種情報とイベントチャネル連携サービスの基本情報を記述します。サービス定義は以下のセクションから構成されます。

• 1個のMNGRセクション
• 0個以上のSERVERセクション
• 0個以上のCHANNELセクション
• 0個以上のRCHANNELセクション

　表1.13にメッセージの送受信で必要なセクションの組み合わせを示します。

[表1.13 メッセージの送受信で必要なセクションの組み合わせ]

セクション		送信の場合	受信の場合
		ノーティフィケーションサービス / JMS	ノーティフィケーションサービス / JMS
MNGR	sproc	○	―
	rproc	―	○
	systemid	○	○
	repository	―	○
	errorretry	△	―
SERVER	name	○	―
	iorfile	○	―
CHANNEL	channelid	○	―
	sndname	○	―
	rcvname	○	―
	evttype	△	―
	server	○	―
	packmsg_cnt	△	―
	packmsg_wtime	△	―
RCHANNEL	rcvname	―	○
	recvnum	―	△

○:必要、△:選択、―:不要

　サービス定義は以下の形式で記述します。

記述形式

[MNGR]
sproc         = メッセージ送信指定
rproc         = メッセージ受信指定
systemid      = MQDサーバ識別子
repository    = インプリメンテーションリポジトリID
errorretry    = エラーリトライ回数

[SERVER]
name          = 送信先MQDサーバ識別子
iorfile       = 送信先イベントチャネル連携サービスのIORファイル名

[CHANNEL]
channelid     = 送信チャネル識別子
sndname       = 送信キュー名
rcvname       = 相手サーバの受信キュー名
evttype       = イベントデータの形式
server        = 送信先MQDサーバ識別子
packmsg_cnt   = パッキング数またはユニット内メッセージ数
packmsg_wtime = 最大遅延時間

[RCHANNEL]
rcvname       = 自サーバの受信キュー名
recvnum       = 集信数

　次に通信モデルに応じたサービス定義の記述方法を以下に示します。なお、以下に示す各通信モデルの定義イメージは、通信モデルの特定に関連する部分だけを抜き出して説明しているため、その他の必要な定義については、表1.13で確認してください。

　また、グローバルサーバへメッセージを送信する場合以外の定義イメージでは、ノーティフィケーションサービス、JMSまたはMQDにメッセージを送信することが前提としています。

送信側の定義

　evttypeキーワードに“structured”を指定します。アプリケーションの都合により“any”を指定することも可能です。その他のキーワードは利用する機能に応じて指定します。

[MNGR]
systemid     = MQDサーバ識別子 NSGWS001

[SERVER]
name         = 送信先MQDサーバ識別子 NSGW1
iorfile      = 送信先イベントチャネル連携サービスのIORファイル名またはURLリストファイル名

[CHANNEL]
channelid    = 送信チャネル識別子 ID1
sndname      = 送信用のイベントチャネル名 または JMSキュー名 S1
rcvname      = 相手サーバの受信キュー名 R1
server       = 送信先MQDサーバ識別子 SV1 
evttype      = structured / any

受信側の定義

　その他のキーワードは利用する機能に応じて指定します。

[MNGR]
systemid     = MQDサーバ識別子 NSGWR00
repository   = インプリメンテーションリポジトリID

[RCHANNEL]
rcvname       = 受信用のイベントチャネル名 または JMSキュー名 R1

ネーミングサービスを使用する相手サーバの指定

　送信側サーバで、SERVERセクションのiorfileキーワードにURLリストファイルを指定します。URLリストファイルには、受信側のサーバを登録したネーミングサービスのURLを記述します。

送信側サーバ

[SERVER]
name           = 送信先MQDサーバ識別子 SV1
iorfile        = URLリストファイルの絶対パス名

　

URLリストファイルの記述

iiop://255.255.255.1:8002    #ネーミングサービスのURL1
iiop://255.255.255.2:8002    #ネーミングサービスのURL2
iiop://255.255.255.255       #ネーミングサービスのURL3

　URLリストファイルの詳細については、“1.3.3.3 URLリストファイルの記述”を参照してください。

IORファイルを使用する相手サーバの指定

　送信側のサーバで、SERVERセクションのiorfileキーワードに受信側のサーバで作成したIORファイルを指定します。

送信側のサーバ

[SERVER]
name          = 送信先MQDサーバ識別子 SV1
iorfile       = 送信先サーバから配布されたIORファイルの絶対パス名

記述内容の説明

a) MNGRセクション

　イベントチャネル連携サービスの動作する基本情報を記述します。記述内容を表1.14に示します。

[表1.14 MNGRセクションの記述内容]

キーワード	省略	データ型	記述方法	記述内容の説明
sproc	可	数値	0または1を指定します。 省略値は1です。 (注1)	メッセージを送信する場合1を指定します。 メッセージの受信だけを行う場合は0を指定してください。
rproc	可	数値	0または1を指定します。 省略値は1です。 (注1)	メッセージを受信する場合1を指定します。 メッセージの送信だけを行う場合は0を指定します。
systemid	不可	文字列	8バイト以内の英数字で指定します。(注2)	本サービスが動作するMQDシステムに対応したMQDサーバ識別子を指定します。MQDサーバ識別子は、本サービスで接続するサーバ間で一意な識別子を指定してください。
repository	rprocが1の時不可	文字列	systemidキーワードで指定したMQDサーバ識別子に固定文字列“NSGWSERVERREPID”を付加した文字列を指定します。	イベントチャネル連携サービスのCORBAサービスへの登録で指定したインプリメンテーションリポジトリIDを指定します。
errorretry	可	数値または文字列	0〜2147483647の数値、またはendlessを指定します。 省略値は12です。	エラー発生時のリトライ回数を指定します。endlessの場合無限リトライとなります。リトライ可能なエラー事象については表1.15を参照してください。
			“continue”を指定します。	無限リトライを意味します。endlessを指定した場合よりより広いエラー事象でもリトライを継続します。リトライ可能なエラー事象については表1.15を参照してください。

1. sprocまたはrprocのどちらか一方に必ず1を設定してください。
2. グローバルサーバと通信を行う場合、先頭が英大文字で始まる8バイト以内の英大文字と数字で指定します。

[表1.15 エラー事象ごとのリトライ可否]

エラー事象	数値またはendless	continue
イベントチャネル連携サービスの送信先MQDサーバが未起動	○	○
イベントチャネル連携サービスの送信先MQDサーバの受信キューの蓄積イベントデータ数が最大蓄積数を超えた	○	○
イベントチャネル連携サービスの非同期メッセージ基盤がMQDの場合に、一時的な異常が発生した	○	○
メッセージ送信先のメッセージキューまたはイベントチャネルが閉塞していた	○	○
メッセージ送信先のイベントチャネル連携サービスの非同期メッセージ基盤がMQDの場合に、メッセージキューが閉塞していた	×	○
通信異常	×	○
メモリ不足	×	○
イベントチャネルへの接続異常	×	○
イベントチャネル連携サービスの環境に異常がある	×	×
イベントチャネル連携サービスのサービス起動時に、送信キューが停止していた	×	×
何らかの異常により、相手サーバの検索に失敗した	×	×
サービスの継続に困難な異常が発生した	×	×

b) SERVERセクション

　イベントチャネル連携サービスが他サーバにメッセージを送信する際に送信先のサーバを特定する相手サーバ情報を記述します。SERVERセクションは0〜128個まで定義できます。

　なお、SERVERセクションの内容を変更(nameキーワードとメッセージ送信先の関係を変更)する場合はサービス環境を再作成する必要があります。

　この定義は、メッセージを送信するサーバにだけ必要です。記述内容については表1.16を参照してください。

[表1.16 SERVERセクションの記述内容]

キーワード	省略	データ型	記述方法	記述内容の説明
name	不可	文字列	8バイト以内の英数字で指定します。(注1)	メッセージ送信先のMQDサーバ識別子を指定します。
iorfile	不可	文字列	255バイト以内の文字列で指定します。	メッセージ送信先のイベントチャネル連携サービスのIORファイル名、またはネーミングサービスのURLリストファイル名を絶対パスで指定します。(注2) (注3)

1. グローバルサーバと通信を行う場合、先頭が英大文字で始まる8バイト以内の英大文字と数字で指定します。
2. IORファイル、URLリストファイルはメッセージを送信するサーバのローカルディスク上に格納してください。
3. グローバルサーバと通信を行う場合、必ずIORファイルを指定してください。

　URLリストファイルの詳細については、“1.3.3.3 URLリストファイルの記述”を参照してください。

c) CHANNELセクション

　メッセージの送信で使用するキューについて、送信キューと受信キューとの対応関係などの送信キュー情報を記述します。CHANNELセクションは0〜128個まで定義でき、メッセージを送信するサーバ側に、送信先の受信キュー単位に必要です。記述内容については表1.17を参照してください。

[表1.17 CHANNELセクションの記述内容]

キーワード	省略	データ型	記述方法	記述内容の説明
channelid	不可	文字列	8バイト以内の英数字で指定します。(注1)	送信チャネル識別子を指定します。 送信チャネル識別子は、MQDシステム内で一意な識別子を指定してください。
sndname	不可	文字列	255バイト以内の英数字、“: ”(コロン)および“_”(アンダースコア)で指定します。“グループ名::チャネル名”で指定します。	送信キュー名を指定します。
rcvname	不可	文字列	255バイト以内の英数字、“: ”(コロン)および“_”(アンダースコア)で指定します。“グループ名::チャネル名”で指定します。(注2)	メッセージ送信先の受信キュー名を指定します。
evttype	可	文字列	structuredまたはanyを指定します。 省略値は“any”です。	メッセージの形式を指定します。ノーティフィケーションサービスを使用するアプリケーションがany型のイベントデータを使用する場合は、anyを指定します。その他の場合は、structuredを指定します。
server	不可	文字列	8バイト以内の英数字で指定します。(注1)	メッセージ送信先のMQDサーバ識別子を指定します。 本値は、SERVERセクションのnameキーワードで指定した値と対応させてください。
packmsg_cnt	可	数値	1〜100の範囲で指定します。 省略値は“1”(本機能を使用しない)です。	複数のメッセージをパッキングして送信する場合に、パッキングするメッセージの最大数を指定します。 packmsg_wtimeキーワード値に指定した時間(秒)が経過しても、本キーワード値に指定した数にメッセージ数が満たない場合、その時点でメッセージを相手システムに送信します。
packmsg_wtime	可	数値	0〜300(秒)の範囲で指定します。 省略値は“0”です。	メッセージがパッキング数に達しない場合に、待ち合わせをするための送信待ち時間(秒)を指定します。 パッキング転送機能を使用する場合にだけ有効です。

1. グローバルサーバと通信を行う場合、先頭が英大文字で始まる8バイト以内の英大文字と数字で指定します。
2. グローバルサーバと通信を行う場合、チャネル名だけを指定します。

d) RCHANNELセクション

　メッセージの受信で使用するキューについて、受信キューの属性(集信数)などの受信キュー情報を記述します。RCHANNELセクションは0〜128個まで定義でき、メッセージを受信するサーバ側に、受信キュー単位に必要です。記述内容については表1.18を参照してください。

[表1.18 RCHANNELセクションの記述内容]

キーワード	省略	データ型	記述方法	記述内容の説明
rcvname	不可	文字列	255バイト以内の英数字、“: ”(コロン)および“_”(アンダースコア)で指定します。“グループ名::チャネル名”で指定します。	受信キュー名を指定します。
recvnum	可	数値	1〜128の範囲で指定します。 省略値は“1”です。	受信キューに送信する送信キュー数を指定します。 集信数はMQDシステム内で最大128まです。