2.10.2　Message Queueアダプタを使ったメッセージキューへのアクセス

(1)　Message Queueアダプタの送信オプション

Message Queueアダプタのメッセージ送信機能は，ビジネスプロセスからのメッセージ送信要求に従い，リソースアダプタを経由し，JMSプロバイダとコネクション接続およびセッション設定を行い，JMSプロバイダへメッセージを送信する機能です。

メッセージの種類は，XML形式メッセージおよびバイナリ形式メッセージを送信できます。

メッセージを送信する場合，送信オプション（JMSプロパティ）を指定できます。Message Queueアダプタ送信オプション一覧を次に示します。

表2‒25　Message Queueアダプタ送信オプション一覧

項目	送信オプションの概要	指定方法
		電文	定義
メッセージ送信先 （JMSDestination）	メッセージの送信キュー。	○	○
メッセージ保持時間 （JMSExpiration）	メッセージの保持時間。メッセージ保持時間とは，JMSプロバイダの送信キューに保持し続ける時間のことです。	×	○
メッセージ永続性 （JMSDeliveryMode）	メッセージの永続性。メッセージ永続性とは，システム障害後，またはJMSプロバイダを再開した場合など，メッセージをキューに保持するかどうかの指定です。	×	○
メッセージ識別ID （JMSMessageID）	メッセージを識別するID。 IBM MQ Resource Adapterを使用する場合，任意の情報が設定されます。	−	−
タイムスタンプ （JMSTimestamp）	メッセージのタイムスタンプ。	−	−
報告メッセージ送信先 （JMSReplyTo）	報告メッセージの送信キュー。	×	×
メッセージタイプ （JMSType）	メッセージタイプ。	×	○
相関識別子 （JMSCorrelationID）	メッセージの相関識別子。	×	△
優先度 （JMSPriority）	メッセージの優先度。IBM MQ Resource Adapterの場合，4が設定されます。	−	−

メッセージ相関識別子を設定したメッセージ送信は，「2.10.2(2)　メッセージ相関識別子の生成方法」を参照してください。

メッセージ送信機能の概要を次に示します。

図2‒86　メッセージ送信機能

1. Message Queueアダプタは，ビジネスプロセスからのメッセージ送信要求を受けてコネクションを接続します。

2. コネクション接続後，送信キューとのセッションを設定します。

3. メッセージ送信要求を実行し，メッセージを送信キューに格納します。Message Queueアダプタ通信構成定義ファイルに送信オプションの指定がある場合，送信オプションを設定してメッセージを送信します。

4. メッセージ送信完了後，セッションを解放します。

5. JMSプロバイダとのコネクションを切断します。

   コネクション切断後，メッセージ送信応答をビジネスプロセスに返します。

ページの先頭へ

(2)　メッセージ相関識別子の生成方法

Message Queueアダプタは，Message Queueアダプタ通信構成定義ファイルの<id_type>タグでType2が指定されている場合，メッセージ相関識別子を自動的に生成し送信メッセージに付与します。

メッセージ相関識別子は，プレフィックスとMessage Queueアダプタ固有情報から構成されています。メッセージ相関識別子の生成方法は，プレフィックスを付与する場合としない場合の2つの方法があります。

なお，Message Queueアダプタ固有情報は，Message Queueアダプタが設定する情報です。

ページの先頭へ

(3)　Message Queueアダプタ使用時のトランザクション

リソースアダプタで提供されるトランザクションサポートレベルは「LocalTransaction」または「XATransaction」を指定してください。ただし，「LocalTransaction」はビジネスプロセスでステータスの永続化をしない場合だけ指定できます。「NoTransaction」は指定できません。

「LocalTransaction」または「XATransaction」を指定すると，JTA（Java Transaction API）と関連を持ちます。例えば，JTAのトランザクションタイムアウト指定値がMessage Queueアダプタ通信構成定義ファイルのメッセージ受信応答監視時間（receive_timeout）より短い場合，JTAのトランザクションタイムアウト指定値でタイムアウトします。

ビジネスプロセスからメッセージ受信要求またはメッセージ送受信要求を受けると，Message Queueアダプタはメッセージ受信要求を発行します。このメッセージ受信要求に対してリソースアダプタが一定時間内にメッセージを受信できない場合，リソースアダプタはメッセージ受信応答監視時間のタイムアウトとなります。リソースアダプタからの通知に従い，Message Queueアダプタは，ビジネスプロセスへFault応答情報を通知します。また，ビジネスプロセスからブラウズ・メッセージ受信要求を受け，ブラウズ・メッセージ受信要求を行いますが，受信キューにメッセージが存在しない場合も，ビジネスプロセスへFault応答情報を通知します。

フォルトが発生したときの処理の定義については，マニュアル「サービスプラットフォーム 開発ガイド 基本開発編」の「5.4.4　フォルト処理を定義する」を参照してください。

ページの先頭へ

(4)　メッセージ送信や受信で使用するJMS API

ページの先頭へ