下記の表では、メッセージ・セットをカスタマイズするために設定できるプロパティーが定義されています。
プロパティー | タイプ | 意味 |
---|---|---|
メッセージ・セット ID | ストリング | これは、メッセージ・セットの作成時に自動的に生成される固有 ID です。 このプロパティーは変更できません。 |
メッセージ・セット別名 | ストリング | メッセージ・セットを識別する代替の固有値を指定します。 このプロパティーが必要なのは、メッセージ ID 手法を使用して組み込みメッセージを識別する場合だけです。 ここで、組み込みメッセージはこのメッセージ・セット内に定義されますが、 親メッセージは別のメッセージ・セット内に定義されます。 さらに、ビット・ストリームには実際のメッセージ・セット名または ID が含まれていません。 |
デフォルト・ワイヤー形式 | ストリング | 形式が、メッセージの MQRFH2 ヘッダーから導き出せない場合、またはメッセージ・フローでメッセージが受信されるときの入力ノードのプロパティーとして指定されていなかった場合、使われるデフォルト・ワイヤー形式を指定します。 デフォルトは空 (設定されていない) です。 |
メッセージ・タイプ接頭部 | ストリング | 特に、メッセージ・パス手法を使用して組み込みメッセージを定義するとき、
このプロパティーは複数パーツのメッセージを定義する際に使われます。
指定する値は、最外部から最内部メッセージへの絶対または相対パスとして使われ、最外部メッセージに指定 した「メッセージ・タイプ」プロパティーの値の接頭部 (メッセージの MQRFH2 ヘッダーか、 メッセージ・フローの入力ノードに指定される) として使われます。 値を設定する場合、id1/id2/.../idnu の形式でなければなりません。id1 は最外部メッセージの ID で、id2 は次のエレメントまたはメッセージの ID で、idn は最内部メッセージの ID です。 デフォルト値はブランク (設定されていない) です。 以下の表では、メッセージ・セット・プロパティー「メッセージ・タイプ接頭部」の使用を説明しており、この値を入力メッセージの「メッセージ・タイプ」プロパティーと組み合わせる方法が示されています。 |
ランタイム・パーサー | ストリング | ドロップダウン・リストからこのセットに属するメッセージのメッセージ・パーサーを選択します。メッセージ・セット内のメッセージ用の ESQL フィールド参照を作成する場合、メッセージ・パーサー名 (InputRoot.MRM.Document など) を使用する必要があります。
マッピング・エディターと、ESQL エディターの内容アシスト機能は、ESQL フィールド参照の生成時にメッセージ・パーサー名を使用します。メッセージ・パーサー名は、メッセージ・セットのメッセージを処理する任意の入力ノードのメッセージ・ドメイン・プロパティー、またはメッセージ・セットのメッセージに先行する任意の MQRFH2 ヘッダーの <Msd> エレメント値と一致する必要があります。
以下から選択できます。
|
ネーム・スペースの使用 | チェック・ボックス | メッセージ・セット内でネーム・スペースを使用する場合は、このプロパティーを選択します。
ネーム・スペースは、異なる文書定義が同じ名前のエレメントを持つという、
命名の競合を避けるための方法を提供します。
詳細については、ネーム・スペースを参照してください。 このプロパティーが一度使用可能にされると、使用不可にはできません。 さらに、ネーム・スペースを使用すると、エレメントが WebSphere Message Broker 論理メッセージ・ツリーで作成される方法にも影響を与えることに注意してください。 メッセージ・ツリー内の各エレメントには、名前とネーム・スペースの両方があるため、それらのエレメントの 1 つに対する ESQL または Java 参照では、名前とネーム・スペースの両方を指定する必要があります。 そのため、ネーム・スペースを使用すると、作成される ESQL または Java に影響を与えます。 メッセージ・セットを使用して、現在または将来 XML メッセージをモデル化する場合は、このプロパティーを選択します ただし、メッセージ・セットが WebSphere Message Broker バージョン 2.1 で実行しているメッセージ・フロー、または WebSphere Message Broker バージョン 2.1 で発生したメッセージ・フローとともに使用される場合には、このプロパティーを選択するべきではありません。なぜなら、そのようなメッセージ・フローはネーム・スペースを認識しないからです。 |
MaxLength としての長さファセットの処理 | チェック・ボックス | COBOL インポーターが、長さファセットではなく、固定長ストリング・エレメント用の maxLength ファセットを作成するようにしたい場合にこのプロパティーを選択します。
デフォルトでは、このプロパティーは設定されています。 |
下記の表には、プロパティー「メッセージ・タイプ接頭部」を 使用することの含意が示されています。メッセージ・タイプまたはメッセージ接頭部の記述は、エレメントまたはメッセージである可能性があることに注意してください。
「メッセージ・タイプ」プロパティーの例 | 「メッセージ・タイプ接頭部」をセットしない | 「メッセージ・タイプ接頭部」をセットする |
---|---|---|
次の単純メッセージ・タイプ:msg_type | 単純メッセージ・タイプでの結果:msg_type | パス・メッセージ・タイプでの結果: /msg_prefix_1/.../msg_prefix_n/ msg_type |
パス・メッセージ・タイプ:msg_type_1/.../msg_type_m | パス・メッセージ・タイプでの結果:/msg_type_1/.../msg_type_m | 組み合わされたパス・メッセージ・タイプでの結果: /msg_prefix_1.../msg_prefix_n /msg_type_1/.../msg_type_m |
単純絶対メッセージ・タイプ:/msg_type | 単純メッセージ・タイプでの結果:msg_type | 単純メッセージ・タイプでの結果:msg_type 「メッセージ・タイプ接頭部」が msg_type 以外 の値に設定されていると、エラーが引き起こされます。 |
パス絶対メッセージ・タイプ:/msg_type_1/.../msg_type_m | パス・メッセージ・タイプでの結果:/msg_type_1/.../msg_type_m | パス・メッセージ・タイプでの結果:/msg_type_1/.../msg_type_m 「メッセージ・タイプ接頭部」のすべての ID が、結果パスでの対応する ID と一致しない場合、エラーが引き起こされます。 |
これは MRM によって定義された最大のメッセージ・オブジェクトなので、このメッセージ・セットには、より大きなオブジェクトのメンバーシップによって指示されたプロパティーはありません。
メッセージ・セット・プロパティーに加え、それぞれの物理フォーマットには、更新可能なプロパティーがあります。 メッセージ・セット用の文書プロパティーもあります。 詳細については、以下を参照してください。