MSMQ アダプタのアウトバウンド接続マッププロパティーの設定

MSMQ キューエイリアス

キューエイリアスを指定します。キューエイリアスは、AD パスとユーザー定義文字列 (エイリアス) を、公開、非公開、または直接の単一要素形式名に関連付けます。 

キューエイリアスを使ってメッセージの送受信を行うには、MSMQ および Active Directory サービスが Application Server と同じコンピュータ上にインストールされている必要があります。

キューエイリアス。 

詳細については、「SOCKS (BatchFTP の接続マップ)」を参照してください。

MSMQ 形式名

キューの形式名を指定します。形式名とは、接続詳細情報やキューのパスを使ってキューを一意に識別する文字列のことです。さまざまなタイプの形式名を使用することで、メッセージのルーティング方法、デスティネーションのタイプ、およびキューのオープン対象となる処理のタイプを指定できます。 

TCP および HTTP プロトコルを受け付けるように MQ のセキュリティー属性を設定してください。 

次の形式の公開または非公開の形式名。 

• 公開キューの場合は次の形式を使用します。

  DIRECT=TCP:

  IPAddress\QueueName

  DIRECT=OS:

  ComputerName\QueueName

  DIRECT=HTTP:

  //Host/msmq/QueueName

• 非公開キューの場合は次の形式を使用します。

  DIRECT=TCP:

  IPAddress\

  private$\QueueName

  DIRECT=OS:

  ComputerName\private$\QueueName

  TCP および HTTP プロトコルを受け付けるように MQ のセキュリティー属性を設定してください。

  公開と非公開の両方の MSMQ 形式名の例については、「転送前 (BatchFTP の接続マップ)」を参照してください。

  ComputerName または Host の名前に含まれる文字が 15 文字を超えている場合、MSMQ はその名前を切り詰めます。その場合、その切り詰められた ComputerName を使用する必要があります。システムの具体的な ComputerName を確認するには、キューの「プロパティ」、「全般」タブを参照してください。詳細については、「転送前 (BatchFTP の接続マップ)」を参照してください。

  詳細については、「SOCKS (BatchFTP の接続マップ)」を参照してください。

MSMQ キュー名

Microsoft メッセージキューの名前を指定します。 

キューを識別する文字列名。これはホスト名に関連付けられているため、host/queue のように値を入力します。ここで、host はホスト名、queue はキュー名です。

詳細については、「SOCKS (BatchFTP の接続マップ)」を参照してください。

MSMQ トランザクションタイプ

アウトバウンドのトランザクションタイプを指定します。オプションは次のとおりです。 

• MQ_NO_TRANSACTION: 非トランザクションキューへのメッセージ送信時にこの値を選択します。

• MQ_XA_TRANSACTION: XA トランザクションキューへのメッセージ送信時にこの値を選択します。

• MQ_SINGLE_MESSAGE: トランザクションキューへのメッセージ送信時にこの値を選択します。

  この値がトランザクションキューからのインバウンドメッセージに適用されたりそのメッセージに影響を与えたりすることはありません。

MQ_NO_TRANSACTION、MQ_XA_TRANSACTION、または MQ_SINGLE_MESSAGE をトランザクションタイプとして選択します。

デフォルト値 MQ_NO_TRANSACTION を使用します。

詳細については、MSMQ のユーザーマニュアルを参照してください。 

MSMQ 共有モード

次のいずれかを使って MSMQ 共有モードを指定します。 

• DENY_NONE: キューが開いている間にキューに対してメッセージの送信、peek、または取得を行える完全なアクセス権を、すべてのユーザーに許可します。

• DENY_RECEIVE_SHARE: キューが閉じられるまで、このユーザーだけがメッセージの peek または取得を行えます。ほかのアプリケーションは、キューへのメッセージの送信は依然として行えますが、このユーザーがキューを開いている間はメッセージの削除を行えません。

DENY_NONE または DENY_RECEIVE_SHARE を選択します。

DENY_NONE がデフォルト設定になります。

エラー条件

Message Queuing がキューを開いたあとで、このユーザーかほかのだれかが RECEIVE_ACCESS または PEEK_ACCESS を使ってそのキューを開こうとすると、エラーメッセージが表示されます。

RECEIVE_ACCESS または PEEK_ACCESS を使ってキューがすでに開かれている状態で、DENY_RECEIVE_SHARE を使ってそのキューを開こうとすると、その呼び出しは失敗します。

メッセージ優先度

すべてのメッセージに対するメッセージ優先レベルを指定します。優先度の範囲は、レベル 0 (低い優先度) から 7 (高い優先度) までです。メッセージはキュー内で降順に格納され、優先度の高いメッセージが先にきます。優先度が有効になるのは、「MSMQ アクセスモード」が SEND_ACCESS に設定されている場合だけです。

メッセージの優先度を示す、0 から 7 までの数値。デフォルト設定は 3 です。

MSMQ 受信アクションコード

次のいずれかを使って MSMQ 受信アクションコードを指定します。 

ACTION_RECEIVE: 現在のカーネル位置にあるメッセージを読み取り、それをキューから削除します。

ACTION_PEEK_CURRENT: キュー内の最後のメッセージを「peek」します。いくつかのメッセージがキューを出入りしていて、最後のメッセージを peek (確認) して取得する必要がある場合に、この機能を使用できます。

ACTION_RECEIVE または ACTION_PEEK_CURRENT を選択します。

ACTION_RECEIVE がデフォルト設定になります。

MSMQ アクセスモード

Message Queuing が peek、送信、受信のいずれのアクセス権を使ってキューを開くかを指定します。 

• RECEIVE_ACCESS: メッセージの読み取り時にそのメッセージをキューから取得できるようにします。これは、受信アプリケーションがメッセージを削除するためにキューを開く場合に使用されます。

• SEND_ACCESS: メッセージをキューに送信できるようにします。これは、送信アプリケーションがメッセージを送信するためにキューを開く場合に使用されます。

• PEEK_ACCESS: メッセージを削除することなしにキューからメッセージを読み取れるようにします。これは、受信アプリケーションがメッセージを読み取るためにキューを開く場合に使用されます。

RECEIVE_ACCESS、SEND_ACCESS、または PEEK_ACCESS を選択します。

メッセージ優先度を使用するには、このアクセスモードを SEND_ACCESS に設定する必要があります。

接続モード

外部接続をインスタンス化する際に物理的な接続を確立するかどうかを指定します。オプションは次のとおりです。 

• 自動: 外部接続をインスタンス化する際に物理的な接続を確立します。

• 手動: 起動時に外部システムへの接続を行わず、代わりに connect() メソッドを呼び出すなどの方法でユーザーがコラボレーションから接続を起動するものと予期します。

「自動」または「手動」 (動的) を選択します。

デフォルト設定は「自動」です。