MessageQueueDirector説明書

3.3.1.2 記述内容の説明（ファイルを使用する場合）

　MQD環境定義の記述内容について以下に説明します。

　なお、本項で指定する各ファイルは、すべて新規ファイルです。ただし、ディレクトリについては、既存の(実在する)ものを指定する必要があります。

a) MQDConfigurationセクション

　MQD環境の情報を記述します。記述内容を表3.4に示します。

[表3.4 MQDConfigurationセクションの記述内容]

キーワード	省略	データ型	記述方法	記述内容の説明
QueueMax	不可	数値	1〜30000の数値で指定します。	作成メッセージキュー数の最大値を指定します。(注1) 1を指定します。
MessageBufferMaxSize	可	数値	1〜1024の数値で指定します。 [Mバイト]の単位で指定します。 省略値は80Mバイトです。	一時的にメッセージを格納するバッファの最大長を指定します。 このバッファは、共有メモリ上に獲得され、不足時に指定された値の1/10ずつ、指定された値まで拡張されます。(注2) 80を指定するか、本キーワードを省略します。
QMKind	可	文字列	“MQD”を指定します。	メッセージ格納ファイルの種別を指定します。

　注1) MQDの拡張機能を使用する場合、各サービスに対して以下の値が必要です。アプリケーションで必要な値に使用するサービスに必要な値を加えた値以上を指定してください。

• イベントチャネル連携サービスを使用する場合
  (送信キュー数 + 受信キュー数) * 2

　注2) 使用バッファ量の見積もりは以下の式に従ってください。

(アプリケーションが1トランザクションで扱うメッセージ長の合計の最大値) * (同時に起動するアプリケーション数) * 2

MQDの拡張機能を使用する場合、上記見積もりに以下の値を追加してください。

サービス名	追加する値
同報配信サービス	同報グループ数 * 平均メッセージ長 * 2
ACM連携サービス	1
イベントチャネル連携サービス	(送信キュー数 + 受信キュー数) * 平均メッセージ長 * 2
SMTP連携サービス	(送信キュー数 + 受信キュー数) * 平均メッセージ長 * 2

b) Transactionセクション

　トランザクション管理ファイル情報を記述します。記述内容を表3.5に示します。

[表3.5 Transactionセクションの記述内容]

キーワード	省略	データ型	記述方法	記述内容の説明
Transaction File	不可	文字列	絶対パス名で指定します。 NTFS(ローカルディスク)上のファイルを指定します。 ローデバイスファイル(推奨)または通常ファイルを指定します。 通常ファイルを指定します。	トランザクション管理ファイルの名前を指定します。
Max_Size	可	数値	16〜65536の数値で指定します。[Kバイト]の単位で指定します。 省略値は65536[Kバイト]です。	1トランザクションで送受信するメッセージ長の合計の10倍を指定します。その値が65536を超える場合には、65536を指定してください。 上限値を設定することで、アプリケーションの異常(異常ループなど)によるMQD資源の圧迫や枯渇を防止できます。（注1） 14400を指定します。

　注1) MQDの拡張機能を使用する場合、各サービスに対して以下の値が必要です。アプリケーションで必要な値に使用するサービスに必要な値を加えた値以上を指定してください。

• ACM連携サービスを使用する場合
  1000
• 同報配信サービスを使用する場合
  1ユニット内のユーザデータ長の合計 + MQDヘッダ長 × 1ユニット内メッセージ数
• イベントチャネル連携サービスを使用する場合
  14400、または
  ユーザデータの最大長[Kバイト] × パッキング数 + 256 を比べて大きいほうの値
  なお、パッキング数は、イベントチャネル連携サービスのサービス定義のpackmsg_cntキーワードで指定します。

• SMTP連携サービスを使用する場合
  1ユニット内のユーザデータ長の合計 + MQDヘッダ長 × 1ユニット内メッセージ数

c) SystemFileセクション

　MQDが使用するシステム制御用ファイルの情報を記述します。記述内容を表3.6に示します。

[表3.6 SystemFileセクションの記述内容]

キーワード	省略	データ型	記述方法	記述内容の説明
SystemFile1	不可	文字列	絶対パス名で指定します。 NTFS(ローカルディスク)上のファイルを指定します。 通常ファイルまたはローデバイスファイルを指定します。 通常ファイルを指定します。	システム制御用ファイル1の名前を指定します。
SystemFile2	不可	文字列	同上	システム制御用ファイル2の名前を指定します。
SystemFile2_Size	不可	数値	80〜2097151の数値で指定します。 [Kバイト]の単位で指定します。	システム制御用ファイル2の容量を指定します。

d) QueueIndexセクション

　メッセージキュー管理ファイル情報を記述します。記述内容を表3.7に示します。

[表3.7 QueueIndexセクションの記述内容]

キーワード	省略	データ型	記述方法	記述内容の説明
File	不可	文字列	絶対パス名で指定します。 NTFS(ローカルディスク)上のファイルを指定します。 通常ファイル(推奨)またはローデバイスファイルを指定します。 通常ファイルを指定します。	メッセージキュー管理ファイルの名前を指定します。

e) DiskQueueセクション

　メッセージ保証レベルがディスク型のメッセージキューを利用する場合に、ディスク型メッセージキューの情報を記述します。記述内容を表3.8に示します。

[表3.8 DiskQueueセクションの記述内容]

キーワード	省略	データ型		記述方法	記述内容の説明
File	不可		文字列	絶対パス名で指定します。 NTFS(ローカルディスク)上のファイルを指定します。 通常ファイル(推奨)またはローデバイスファイルを指定します。 通常ファイルを指定します。	ディスク型メッセージキューのメッセージ格納域(メッセージ格納ファイル)の名前を指定します。
Size	不可		数値	80〜2097151の数値で指定します。[Kバイト]の単位で指定します。	ディスク型メッセージキューのメッセージ格納域(メッセージ格納ファイル)の容量を指定します。(注1) 80を指定します。

　注1) MQDの拡張機能を使用する場合、各サービスに対して以下の値が必要です。アプリケーションで必要な値に使用するサービスに必要な値を加えた値以上を指定してください。

f) MemoryQueueセクション

　メッセージ保証レベルがメモリ型のメッセージキューを利用する場合に、メモリ型メッセージキューの情報を記述します。記述内容を表3.9に示します。

　本セクションを記述する必要はありません。

[表3.9 MemoryQueueセクションの記述内容]

キーワード	省略	データ型	記述方法	記述内容の説明
File	不可	文字列	絶対パス名で指定します。 NTFS(ローカルディスク)上のファイルを指定します。 通常ファイルを指定します。	メモリ型メッセージキューのメッセージ格納域を管理するファイルの名前を指定します。
Size	不可	数値	80〜524288の数値で指定します。 [Kバイト]の単位で指定します。	メモリ型メッセージキューのメッセージ格納域(メモリ上)の容量を指定します。メモリ型メッセージキューのメッセージ格納域の容量見積もり式は、ディスク型と同一ですので、“表3.2 ファイル容量の見積り方法(ファイルを使用する場合)”の“ディスク型メッセージキューのメッセージ格納域”の式で求めてください。

g) WatchQueueUsedセクション

　メッセージ格納域の使用状況の監視を行う場合に記述します。記述内容を表3.10に示します。

　本セクションを記述する必要はありません。

[表3.10 WatchQueueUsedセクションの記述内容]

キーワード	省略	データ型	記述方法	記述内容の説明
DiskQueue	可	数値	“安全値-警告値”の形式で指定します。安全値は0〜99[%]、警告値は1〜100[%]の範囲で指定します。安全値と警告値は、安全値 ＜ 警告値の関係でなければなりません。	ディスク型メッセージキューのメッセージ格納域の使用量に対する安全値と警告値を設定します。キーワードを省略した場合、メッセージ格納域がない場合、メッセージ格納域の使用状況監視は行われません。
MemoryQueue	可	数値	“安全値-警告値”の形式で指定します。安全値は0〜99[%]、警告値は1〜100[%]の範囲で指定します。安全値と警告値は、安全値 ＜ 警告値の関係でなければなりません。	メモリ型メッセージキューのメッセージ格納域の使用量に対する安全値と警告値を設定します。キーワードを省略した場合、メッセージ格納域がない場合、メッセージ格納域の使用状況監視は行われません。