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

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

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

注:

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

名前

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

データ型 ストリング
説明

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

データ型 ストリング
JNDI 名

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

パーシスタンス

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

データ型 列挙型
デフォルト APPLICATION_DEFINED
範囲
アプリケーションで定義
宛先上のメッセージのパーシスタンスは、 そのメッセージをキューに入れたアプリケーションで定義されます。
キュー定義
[WebSphere MQ 宛先のみ] 宛先上のメッセージのパーシスタンスは、 WebSphere MQ キュー定義プロパティーで定義されます。
パーシスタント
宛先上のメッセージは永続的です。
非パーシスタント
宛先上のメッセージは永続的ではありません。
優先順位

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

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

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

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

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

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

有効期限切れタイムアウト (Expiry Timeout)」プロパティーが「指定済み (Specified)」に設定されている場合、秒数をミリ秒単位 (0 より大きい値) で入力します。この秒数の後、このキュー・マネージャーのメッセージが有効期限切れになります。

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

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

データ型 ストリング
基本キュー・マネージャー名

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

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

データ型 ストリング
単位 En_US ASCII 文字
範囲 1 から 48 文字の ASCII 文字で表される、有効な WebSphere MQ キュー・マネージャー名。
CCSID

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

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

データ型 ストリング
整数エンコード

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

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

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

10 進数エンコード

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

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

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

浮動小数点エンコード

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

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

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

ネイティブ・エンコード

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

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

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

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

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

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

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

データ型 ドロップダウン・リスト
デフォルト UNSPECIFIED
範囲
UNSPECIFIED
メッセージを送信するときに、WebSphere MQ メッセージング・プロバイダーが RFH バージョン 2 ヘッダーを生成し含めるかどうかは、この宛先プロパティーへ送信されるメッセージへの Append RFH バージョン 2 ヘッダーの値に応じます。 メッセージを受信するときには、WebSphere MQ メッセージング・プロバイダーは値に JMS が設定されているときと同じように機能します。
JMS
メッセージを送信するときに、WebSphere MQ メッセージング・プロバイダーは自動的に RFH バージョン 2 ヘッダーを生成し、それを WebSphere MQ メッセージに含めます。 メッセージを受信するときに、WebSphere MQ メッセージング・プロバイダーは、RFH バージョン 2 ヘッダーの値に従って (値が存在する場合)、JMS メッセージ・プロパティーを設定します。 しかし、JMS メッセージ本文の一部として RFH バージョン 2 ヘッダーは示されません。
MQ
メッセージを送信するときに、WebSphere MQ メッセージング・プロバイダーは RFH バージョン 2 ヘッダーを生成しません。 メッセージを受信するときには、WebSphere MQ メッセージング・プロバイダーは、JMS メッセージ本文の一部として RFH バージョン 2 ヘッダーを示します。
ReplyTo 宛先スタイル (ReplyTo Destination Style)

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

データ型 ドロップダウン・リスト
デフォルト DEFAULT
範囲
DEFAULT
デフォルト値は、RFH バージョン 2 ヘッダーの情報と同じです。
MQMD
MQMD に指定された値を使用します。 これは WebSphere MQ バージョン 6.0.2.4 および 6.0.2.5 のデフォルトの動作と同じで、MQMD の値を使用して応答をキュー・マネージャー・フィールドへ取り込みます。
RFH2
RFH バージョン 2 ヘッダーに指定された値を使用します。 送信側のアプリケーションで JMSReplyTo 値が設定されている場合、その値が使用されます。
MQMD 読み取り可能 (MQMD Read Enabled)

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

データ型 チェック・ボックス
デフォルト クリア
範囲
クリア
アプリケーションは MQMD フィールドの値を読み取れません。
選択
アプリケーションは MQMD フィールドの値を読み取れます。
MQMD 書き込み可能 (MQMD Write Enabled)

WebSphere 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 を指定します。
カスタム・プロパティー

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

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




マーク付きのリンク (オンライン) では、インターネットにアクセスする必要があります。



ファイル名: ucli_pqdsm.html