アプリケーション・クライアントの IBM MQ プロバイダーのキュー宛先設定

このパネルを使用して、IBM MQ 製品の Java™ Message Service (JMS) プロバイダーで使用するために選択されたキュー宛先の構成プロパティーを表示または変更します。

この「アプリケーション・クライアント・リソース構成ツール (ACRCT)」ページを表示するには、「ファイル」 > 「オープン」とクリックします。EAR ファイルのブラウズ後、「オープン」をクリックします。 選択した JAR ファイルを展開して、「メッセージング・プロバイダー」 > 「IBM MQ プロバイダー」とクリックします。 「Queue Destinations」を右マウス・ボタン・クリックして、「新規」をクリックします。 「一般」タブ上に以下のフィールドが表示さ れます。

注:
  • 指定するプロパティー値は、IBM MQ 用に JMS リソースを構成する際に指定した値と一致していなければなりません。 IBM MQ 用に JMS リソースを構成することについて詳しくは、IBM MQ インフォメーション・センターの『Java の使用』を参照してください。
  • IBM MQ では、最大 48 文字までの名前を使用できます。

IBM MQ 製品の JMS プロバイダーで使用するキューには、以下のプロパティーがあります。

名前

WebSphere® Application Server 内で、このキューを管理目的で使用する際の名前。

通知 値
データ型 ストリング

説明

WebSphere Application Server 内で管理目的で使用する、キューの説明。

通知 値
データ型 ストリング

JNDI 名

アプリケーション・クライアントのランタイム環境は、このフィールドを使用して構成情報を検索します。

パーシスタンス

宛先に送信されるすべてのメッセージがパーシスタント、非パーシスタントのい ずれであるか、あるいはメッセージのパーシスタンスをアプリケーシ ョンで定義するかどうかを指定します。

通知 値
データ型 列挙型
デフォルト APPLICATION_DEFINED
範囲
アプリケーションによる定義
宛先にあるメッセージのパーシスタンスは、それらのメッセージをキューに入れるアプリケーションによって定義されます。
キュー定義
[IBM MQ 宛先のみ] 宛先にあるメッセージのパーシスタンスは、IBM MQ キュー定義のプロパティーによって定義されます。
パーシスタント
宛先上のメッセージはパーシスタントです。
非パーシスタント
宛先上のメッセージはパーシスタントではありません。

優先順位

この宛先のメッセージ優先順位をアプリケーションで定義するか、「指定された優先順位」プロパティーで定義するかを指定します。

通知 値
データ型 列挙型
単位 該当なし
デフォルト APPLICATION_DEFINED
範囲
アプリケーションによる定義
この宛先にあるメッセージの優先順位は、それらのメッセージを宛先に送るアプリケーションによって定義されます。
キュー定義
[IBM MQ 宛先のみ] 宛先にあるメッセージのパーシスタンスは、IBM MQ キュー定義のプロパティーによって定義されます。
指定
この宛先にあるメッセージの優先順位は、「指定された優先順位」プロパティーによって定義されます。 このオプションを選択した場合は、 「指定された優先順位」プロパティーで優先順位を定義する必要があります。

指定された優先順位

「優先順位」プロパティーが「指定」に設定 されている場合、このキューのメッセージ優先順位を 0 (最低) から 9 (最高) の範囲で指定します。

通知 値
データ型 整数
単位 メッセージ優先順位のレベル
範囲 0 (最低優先順位) から 9 (最高優先順位)

有効期限

このキューの有効期限切れタイムアウト値がアプリケーションまたは「指定された有効期限」プロパティーのいずれかで定義されているか、 またはキューのメッセージの有効期限が切れないようにする (有効期限切れタイムアウトを無限にする) かどうかを指定します。

通知 値
データ型 列挙型
単位 該当なし
デフォルト APPLICATION_DEFINED
範囲
アプリケーションによる定義
このキューのメッセージの有効期限切れタイムアウトは、 そのメッセージをキューに入れたアプリケーションで定義されます。
指定
このキューのメッセージの有効期限切れタイムアウトは、 「指定された有効期限」プロパティーで定義されます。 このオプションを選択した場合は、「指定された有効期限」プロパティー でタイムアウトを定義する必要があります。
無制限
このキューのメッセージには、有効期限切れタイムアウトがないため、これらのメッセージの有効期限が切れることはありません。

指定された有効期限

「有効期限切れタイムアウト」プロパティーが「指定」に設定されている場合、このキューのメッセージの有効期限が切れるまでの時間 (0 より大) をミリ秒数で入力します。

通知 値
データ型 整数
単位 ミリ秒
範囲 0 以上
  • 0 は、メッセージがタイムアウトにならないことを示します。
  • それ以外の値は、ミリ秒を表す整数です。

基本キュー名

「基本キュー・マネージャー名」プロパティーによって指定されたキュー・マネージャー上にある、メッセージが送信されるキューの名前。

通知 値
データ型 ストリング

基本キュー・マネージャー名

メッセージの送信先となる IBM MQ キュー・マネージャーの名前。

このキュー・マネージャーは、「基本キュー名」プロパティーで指定されたキューを提供します。

通知 値
データ型 ストリング
単位 En_US ASCII 文字
範囲 有効な IBM MQ キュー・マネージャー名 (1 から 48 文字の ASCII 文字)。

CCSID

IBM MQ キュー・マネージャーで使用するコード化文字セット ID。

このコード化文字セット ID (CCSID) は、IBM MQ キュー・マネージャーがサポートする CCSID の 1 つでなければなりません。詳しくは、IBM MQ メッセージング・プロバイダーのキューおよびトピックの拡張プロパティー設定を参照してください。

通知 値
データ型 ストリング

整数エンコード

ネイティブ・エンコードが使用可能になっていない場合、整数エンコードが NORMAL か REVERSED かを選択してください。

通知 値
データ型 列挙型
デフォルト NORMAL
範囲
NORMAL
標準の整数エンコードが使用されます。
REVERSED
逆の整数エンコードが使用されます。

エンコード・プロパティーについて詳しくは、IBM MQ インフォメーション・センターの『Java の使用』を参照してください。

10 進数エンコード

ネイティブ・エンコードが使用可能になっていない場合、10 進数エンコードが NORMAL か REVERSED かを選択してください。

通知 値
データ型 列挙型
デフォルト NORMAL
範囲
NORMAL
標準の 10 進数エンコードが使用されます。
REVERSED
逆の 10 進数エンコードが使用されます。

エンコード・プロパティーについて詳しくは、IBM MQ インフォメーション・センターの『Java の使用』を参照してください。

浮動小数点エンコード

ネイティブ・エンコードが使用可能になっていない場合、浮動小数点エンコードのタイプを選択してください。

通知 値
データ型 列挙型
デフォルト IEEENORMAL
範囲
IEEENORMAL
IEEE 標準浮動小数点エンコードが使用されます。
IEEEREVERSED
IEEE 逆浮動小数点エンコードが使用されます。
S390
S390 浮動小数点エンコードが使用されます。

エンコード・プロパティーについて詳しくは、IBM MQ インフォメーション・センターの『Java の使用』を参照してください。

ネイティブ・エンコード

このチェック・ボックスを選択した場合、キュー宛先がネイティブ・エンコード (Java プラットフォームに適したエンコード値) を使用することを示します。

通知 値
データ型 列挙型
デフォルト クリア
範囲
クリア
ネイティブ・エンコードは使用されないため、整数エンコード、小数エンコード、および 浮動小数点エンコードに対して以下のプロパティーを指定してください。
選択
(Java プラットフォームに適したエンコード値を提供するために) ネイティブ・エンコードが使用されます。

エンコード・プロパティーについて詳しくは、IBM MQ インフォメーション・センターの『Java の使用』を参照してください。

ターゲット・クライアント

受信側のアプリケーションが JMS に準拠しているか、または従来の IBM MQ アプリケーションであるかを指定します。

通知 値
データ型 列挙型
デフォルト IBM MQ
範囲
IBM MQ
ターゲットは、JMS をサポートしていない従来の IBM MQ アプリケーションです。
JMS
ターゲット・アプリケーションは、JMS をサポートしています。

メッセージ本体

JMS メッセージ本文の一部分として IBM MQ メッセージの RFH バージョン 2 ヘッダーをアプリケーションで処理するかどうかを指定します。

通知 値
データ型 ドロップダウン・リスト
デフォルト UNSPECIFIED
範囲
UNSPECIFIED
メッセージを送信する際には、IBM MQ メッセージング・プロバイダーは、「この宛先に送信するメッセージに、RFH バージョン 2 ヘッダーを付加」プロパティーの値によって、RFH バージョン 2 ヘッダーの生成と組み込みを行ったり行わなかったりします。 メッセージを受信する際には、IBM MQ メッセージング・プロバイダーはこの値が JMS に設定されているかのように処理します。
JMS
メッセージを送信する際には、IBM MQ メッセージング・プロバイダーは、自動的に RFH バージョン 2 ヘッダーを生成し、それを IBM MQ メッセージに組み込みます。 メッセージを受信する際には、IBM MQ メッセージング・プロバイダーは RFH バージョン 2 ヘッダーの値が指定されていればその値に従って JMS メッセージ・プロパティーを設定します。RFH バージョン 2 ヘッダーを JMS メッセージ本体の一部として扱いません。
MQ
メッセージを送信する際には、IBM MQ メッセージング・プロバイダーは RFH バージョン 2 ヘッダーを生成しません。 メッセージを受信する際には、IBM MQ メッセージング・プロバイダーは RFH バージョン 2 ヘッダーを JMS メッセージ本体の一部として扱います。

ReplyTo 宛先スタイル

JMSReplyTo フィールドの形式を指定します。

通知 値
データ型 ドロップダウン・リスト
デフォルト DEFAULT
範囲
DEFAULT
デフォルト値は、RFH バージョン 2 ヘッダー内の情報と同じです。
MQMD
MQMD で指定された値を使用します。 これにより、キュー・マネージャー・フィールドへの応答には MQMD からの値が設定されます。これは IBM MQ バージョン 6.0.2.4 および 6.0.2.5 のデフォルト動作と同じです。
RFH2
RFH バージョン 2 ヘッダーに指定された値を使用します。 送信アプリケーションが JMSReplyTo 値を設定すれば、その値が使用されます。

MQMD 読み取り可能 (MQMD read enabled)

アプリケーションが、IBM MQ メッセージング・プロバイダーを使用して送受信される JMS メッセージから MQMD フィールドの値を読み取れるかどうかを指定します。

通知 値
データ型 チェック・ボックス
デフォルト クリア
範囲
クリア
アプリケーションは MQMD フィールドの値を読み取ることはできません。
選択
アプリケーションは MQMD フィールドの値を読み取ることができます。

MQMD 書き込み可能 (MQMD write enabled)

IBM MQ メッセージング・プロバイダーを使って送受信される JMS メッセージに、アプリケーションが MQMD フィールドの値を書き込むことができるかどうかを指定します。

通知 値
データ型 チェック・ボックス
デフォルト クリア
範囲
クリア
アプリケーションは MQMD フィールドの値を書き込むことはできません。
選択
アプリケーションは MQMD フィールドの値を書き込むことができます。

MQMD メッセージ・コンテキスト (MQMD message context)

宛先へのメッセージ送信時に指定されるメッセージ・コンテキスト・オプションを定義します。

通知 値
データ型 ドロップダウン・リスト
デフォルト DEFAULT
範囲
DEFAULT
MQOPEN API 呼び出しおよび MQPMO 構造は、明示的なメッセージ・コンテキスト・オプションを指定しません。
SET_IDENTITY_CONTEXT
MQOPEN API 呼び出しはメッセージ・コンテキスト・オプション MQOO_SET_IDENTITY_CONTEXT を指定し、 MQPMO 構造は MQPMO_SET_IDENTITY_CONTEXT を指定します。
SET_ALL_CONTEXT
MQOPEN API 呼び出しはメッセージ・コンテキスト・オプション MQOO_SET_ALL_CONTEXT を指定し、MQPMO 構造は MQPMO_SET_ALL_CONTEXT を指定します。

カスタム・プロパティー

このリソースの実行時に作成されるオブジェクトに関する追加のプロパティーを設定するための、 名前と値のペアを指定します。

このオブジェクトのパブリック・プロパティーの名前、およびストリングから このプロパティーのセット・メソッドが必要とするタイプに変換できる値を入力する必要が あります。受け入れ可能なプロパティーと値は作成されるオブジェクトによって 異なります。有効なプロパティーと値のリストについては、 オブジェクトの資料を参照してください。


トピックのタイプを示すアイコン 参照トピック



タイム・スタンプ・アイコン 最終更新: last_date
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-base-dist&topic=ucli_pqdsm
ファイル名:ucli_pqdsm.html