通信アダプタ用 Java CAPS プロジェクトコンポーネントの構成

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

インバウンド MSMQ アダプタの設定情報は、次の各トピックに編成されています。

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

これらのプロパティーのうちの 1 つ、たとえば形式名を使ってキューを識別する場合、ほかの 2 つのプロパティーの値は空のままにしておくことをお勧めします (この場合であれば、「MSMQ キューエイリアス」および「MSMQ キュー名」プロパティーを空のままにする)。これにより、ユーザーが指定したキュー識別方式だけが確実に使用されるようになります。

インバウンド MSMQ 接続マッププロパティーの「MSMQ 設定」セクションには、次の表に示す最上位パラメータが含まれています。

表 1–55 接続マップ - インバウンド - MSMQ 設定

名前 

説明 

必要な値 

MSMQ キューエイリアス

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

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

キューエイリアス。 

詳細については、「MSMQ キューの識別」を参照してください。

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 の接続マップ)」を参照してください。


    詳細については、「MSMQ キューの識別」を参照してください。

MSMQ キュー名

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

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

詳細については、「MSMQ キューの識別」を参照してください。

MSMQ 共有モード

MSMQ 共有モード (DENY_NONE または DENY_RECEIVE_SHARE) を指定します。

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

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

MSMQ アクセスモード

MSMQ アクセスモードを指定します。 

インバウンドモードでサポートされているのは、RECEIVE_ACCESS だけです。 

RECEIVE_ACCESS 

MSMQ 受信間隔

ポーリング間隔、つまりアダプタがキュー内に受信メッセージがないか確認する頻度、をミリ秒で指定します。 

ポーリング間隔をミリ秒で示す数値。 

デフォルト設定は 5000 (5 秒) です。

MSMQ 受信アクションコード

MSMQ 受信アクションコードを指定します。 

インバウンドモードでサポートされているのは、ACTION_RECEIVE だけです。 

ACTION_RECEIVE 

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

Microsoft メッセージトランザクションタイプを指定します。 

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

MSMQ キューの識別

MSMQ アダプタは、次の 3 つのプロパティーのうち、次の順番で最初に使用可能になった値を使って MSMQ キューを識別します。

  1. MSMQ キューエイリアス

  2. MSMQ 形式名

  3. MSMQ キュー名

MSMQ 形式名とホスト名

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

公開または非公開の形式名プロパティーの値は、次のようにして入力します。

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