DestinationData サブツリー内のエレメントのデータ・タイプ

DestinationData サブツリーは、LocalEnvironment ツリーの Destination サブツリーの一部です。LocalEnvironment ツリーは、入力ノードがメッセージを受信するときに入力ノードによって作成されますが、オプションで、計算ノードによっても作成されます。作成時は空ですが、任意の SQL ノードでコード化された ESQL ステートメントを使用して、その中にデータを作成できます。

Destination サブツリーは、ゼロ以上のプロトコル (WebSphere MQWebSphere MQ Everyplace など) のサブツリー、またはルーティング宛先 (RouterList) のサブツリー、もしくはその両方から構成されます。

プロトコル・ツリーには、以下の 2 つの子があります。

LocalEnvironment ツリー構造には、典型的なツリーの図式が含まれています。これは、プロトコルと RouterList サブツリーの両方を含む Destination ツリーを示しています。

DestinationData フォルダー内のデータの構造は、同一プロトコルの Defaults と同じであり、これを使用して Defaults のデフォルト値をオーバーライドできます。したがって、すべての宛先に共通の値を含むために Defaults をセットアップし、 それぞれの DestinationData サブツリーに固有な値だけを設定できます。 DestinationData でも Defaults でも値が設定されない場合、対応するノード・プロパティーに設定していた値が使用されます。

WebSphere MQ の、Defaults および DestinationData サブツリーの各エレメントのフィールド、 データ型、および有効値を以下の表に示します。MQOutput ノードは、対応するノード・プロパティーについて説明しています

DestinationData の使用についての詳細は、LocalEnvironment ツリーへのアクセスを参照してください。

エレメントのデータ・タイプ 意味 対応するノード・プロパティー 有効な値
queueManagerName CHARACTER キュー・マネージャー名  
queueName CHARACTER キュー名  
transactionMode CHARACTER トランザクション・モード no、yes、automatic
persistenceMode CHARACTER 持続モード no、yes、automatic、asQdef
newMsgId CHARACTER 新規メッセージ ID no、yes
newCorrelId CHARACTER 新規相関 ID no、yes
segmentationAllowed CHARACTER セグメント化可能 no、yes
alternateUserAuthority CHARACTER 代替ユーザー権限 no、yes
replyToQMgr CHARACTER 応答先キュー・マネージャー  
replyToQ CHARACTER 応答先キュー  

データ・タイプおよび値の大/小文字の区別

DestinationData フォルダー内でこれらのフィールドを作成する場合は、データ・タイプおよび値を表に示されているとおり正確に入力する必要があります。スペルまたは大/小文字を変更すると、これらのフィールドまたは値は DestinationData レコードで無視され、次に使用可能な値が使用されます。

例えば、以下の ESQL サンプルは、予期しない出力となる可能性があります。

SET OutputLocalEnvironment.Destination.MQ.DestinationData[1].persistenceMode = 'YES';
SET OutputLocalEnvironment.Destination.MQ.DestinationData[2].PersistenceMode = 'yes';

いずれの場合も、DestinationData フォルダーは、これらの宛先の持続メッセージを作成しない可能性があります。最初の例では、persistenceMode フィールドの値は 'YES' になっていますが、上記の表にリストされている有効な値のいずれでもないために無視されます。2 番目の例では、'PersistenceMode' という名前のフィールドの指定が間違っているために無視されます。Defaults フォルダーの persistenceMode 値、または MQOutput ノードの関連属性の値が使用されます。これによって 'no' または 'automatic' という値が使用される場合、持続メッセージは作成されません。

DestinationData フォルダーが予期しない出力を生成する場合は、使用されているフィールドや値の大/小文字およびスペルが正しいことを確認する必要があります。

関連概念
メッセージ・フローの概要
LocalEnvironment ツリー構造
関連タスク
宛先リストの作成
LocalEnvironment ツリーへのアクセス
関連資料
メッセージ・パーサーのエレメント定義
フィールドおよびエレメントのデータ・タイプ
WebSphere MQ ヘッダー内のフィールドのデータ・タイプ
Properties サブツリー内のエレメントのデータ・タイプ
MRM メッセージ内のエレメントのデータ・タイプ
未構造化 (BLOB) メッセージのデータ・タイプ
特記事項 | 商標 | ダウンロード | ライブラリー | サポート | フィードバック
Copyright IBM Corporation 1999, 2006 最終更新: 08/21/2006
ad09630_