MessageQueueDirector説明書

2.2.9 複数メッセージキューからのメッセージ参照

　複数メッセージキューからのメッセージ参照は、指定した複数のメッセージキューのいずれかのメッセージキューよりメッセージの内容を参照する機能です。複数メッセージキューからのメッセージ参照は、プログラムインタフェースの“MQDPEEKMSGEX”または“mqd_peekmsgex”により行うことができます。メッセージの参照によって、メッセージがメッセージキューから削除されることはありません。

複数メッセージキューからのメッセージ参照の方法には以下があります。

• 同期モード
• 非同期モード

　同期モードのメッセージ参照は、指定したメッセージキューのいずれかにメッセージがある場合には、当該のメッセージキューより直ちにメッセージを参照します。指定したすべてのメッセージキューにメッセージがない場合には、いずれかのメッセージキューにメッセージが到着するまで待ち合わせます。

　非同期モードのメッセージ参照は、指定したメッセージキューのいずれかにメッセージがある場合には、当該のメッセージキューより直ちにメッセージを参照します。指定したすべてのメッセージキューにメッセージがない場合には、メッセージ到着を待ち合わせずにアプリケーションに復帰します。

　複数メッセージキューからのメッセージ参照を中止する条件として以下があります。

• 指定した複数のメッセージキューのいずれかが、削除・切断・使用禁止またはアクセス禁止の場合はメッセージの参照を中止して、アプリケーションに復帰します。
• 指定した複数のメッセージキューのすべてが、削除・切断・使用禁止またはアクセス禁止の場合はメッセージの参照を中止して、アプリケーションに復帰します。

　なお、複数メッセージキューからのメッセージ参照を行う場合は、以下のことに留意する必要があります。

• 　事前に、プログラムインタフェースの“MQDCONNECTQEX”または“mqd_connectqex”によって複数のメッセージキューに接続する必要があります。
• 　一つのアプリケーションで、同一のメッセージキューに対してCOBOL言語プログラムインタフェースの“MQDGETMSGEX”と“MQDPEEKMSGEX”を組み合わせて使用することはできません。また、C言語プログラムインタフェースの“mqd_getmsgex”と“mqd_peekmsgex”を組み合わせて使用することはできません。
• 　メッセージの参照は、特定のメッセージキューに集中しないようにメッセージが存在するメッセージキューの中から任意に参照します。ただし、参照したメッセージが1ユニット複数メッセージの場合は、1ユニットすべてのメッセージを参照するまで同一のメッセージキューより参照します。
• 　カーソルは、指定したメッセージキューごとに以下の動作になります。
  • メッセージ参照後、カーソルを次のメッセージに位置付けます。