アプリケーション・クライアントの 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-nd-mp&topic=ucli_pqdsm
ファイル名:ucli_pqdsm.html