2.2.1 ローカルキュー
ローカルキューは,自システムのアプリケーション間で送受信するメッセージ,またはサーバ間転送のために受信したメッセージを登録するキューです。自システムのアプリケーションは,ローカルキューを指定してメッセージを送信したり,受信したりします。なお,hrmstopqueコマンドを使用して,アプリケーションのメッセージの送受信,およびサーバ間転送のメッセージの送受信を抑止できます。サーバ間転送の詳細は,「2.4 メッセージのキュー間転送」を参照してください。
ローカルキューは,永続版リソースアダプタ,非永続版リソースアダプタのどちらの場合も使用できます。永続版リソースアダプタ,非永続版リソースアダプタのローカルキューの概要をそれぞれ説明します。
- 〈この項の構成〉
(1) 永続版リソースアダプタの場合
永続版リソースアダプタのローカルキューの概要を次の図に示します。
-
作成方法
永続版リソースアダプタのローカルキューを作成するには,hrmmkqueコマンドの-tオプションにlocalを指定します。
-
送受信できるメッセージ種別
永続版リソースアダプタのローカルキューには,アプリケーションは次に示すメッセージインタフェースを使用してメッセージを送受信できます。
-
Message
-
BytesMessage
-
ObjectMessage
-
TextMessage
なお,送受信するメッセージはReliable Messagingが提供するQueueSessionインタフェースのメソッドで生成したオブジェクトです。
-
(2) 非永続版リソースアダプタの場合
非永続版リソースアダプタの場合,使用できるのは非永続キュー属性のローカルキューだけです。また,サーバ間転送によるメッセージ受信はできません。
非永続版リソースアダプタのローカルキューの概要を次の図に示します。
-
作成方法
キュー定義文(定義の先頭にhrmmkqueを記述)を指定して,キュー作成ファイルを作成します。キュー作成ファイルに指定したキュー定義文を基に,Reliable Messaging開始時に非永続キュー属性のローカルキューが作成されます。
-
送受信できるメッセージ種別
非永続版リソースアダプタのローカルキューには,アプリケーションは次に示すメッセージインタフェースを使用してメッセージを送受信できます。
-
Message
-
BytesMessage
-
ObjectMessage(ペイロードにBytesContainerは格納できない)
-
TextMessage
なお,送受信するメッセージはReliable Messagingが提供するQueueSessionインタフェースのメソッドで生成したオブジェクトです。
-