メッセージ・セットのマイグレーション

メッセージ・セットを使用するメッセージ・フローをマイグレーションする場合は、WebSphere® Message Broker バージョン 7.0の動作の変更点を確認してください。

バージョン 6.0 からマイグレーションする場合は、メッセージ・セットの変更点とその影響について、この情報を検討してください。バージョン 6.1 からメッセージ・セットをマイグレーションする必要はありません。

マイグレーション・コマンドを実行する必要はありません。バージョン 6.0 のメッセージ・セット・プロジェクトを最初に変更して保存するときに、WebSphere Message Broker Toolkit バージョン 7.0 は、そのメッセージ・セット・プロジェクトを読み取って、バージョン 7.0 の形式に自動的に変換できます。

パーサーの動作の変更内容に関するガイダンス、およびマイグレーションに関する一般情報については、以下のセクションを参照してください。

XMLNSC パーサーにおける動作の変更点

以下の変更内容は、バージョン 7.0に実装されています。

  • バージョン 6.0 では、XML 文書内のエレメントに表示されるときと同じ順序で、XML エレメントの属性が XMLNSC パーサーによって作成されるメッセージ・ツリーに表示されます。

    バージョン 7.0 で、XMLNSC パーサーはメッセージ・ツリーを作成するときに、常にネーム・スペース属性を他の属性よりも前に表示します。 ただし、XML 属性は本質的に順序付けがないので、属性の位置を前提とするメッセージ・フロー・ロジックは記述しないでください。

  • バージョン 6.0 で、XMLNSC パーサーは EBCDIC NEL を z/OS® でのみ XML 改行文字として受け入れます。

    バージョン 7.0 で、NEL はすべてのプラットフォームで受け入れられます。

  • バージョン 6.0 で、XMLNSC パーサーはノードの「妥当性検査」プロパティー設定を無視します。

    バージョン 7.0 で、XMLNSC パーサーは「妥当性検査」プロパティー設定に従います。 このプロパティーを「内容」または「内容と値」に設定した場合、パーサーはメッセージを「メッセージ・セット」プロパティーで定義されたメッセージ・セットに照らして妥当性検査します。

    そのため、バージョン 6.0 の「妥当性検査」プロパティーを、間違えて「内容」または「内容と値」に設定した場合、メッセージ・フローはバージョン 7.0 へのマイグレーションの後に例外をスローします。

    この状態を訂正するには、「妥当性検査」プロパティーを「なし」に設定します。

  • バージョン 6.0 で、XMLNSC パーサーはタイプ TIMESTAMP または GMTTIMESTAMP のフィールドを書き込むとき、デフォルトの ESQL 形式 "YYYY-MM-DD hh:mm:ss" を使用します。 この形式は、XML スキーマ 1.0 仕様に準拠していません。

    バージョン 7.0 で、XMLNSC パーサーは XML スキーマ 1.0 仕様に準拠した形式 "YYYY-MM-DD'T'hh:mm:ss.sss" を使用します。 別の形式が書き込まれる必要がある場合、TIMESTAMP または GMTTIMESTAMP を CHARACTER にキャストする必要があります。 (エレメントが最初に XMLNSC パーサーによって構文解析されていて、時間帯標識を持つ場合、その時間帯標識は出力メッセージ・フィールドにも書き込まれます。)

  • バージョン 6.0 で、XMLNSC パーサーはタイプ BOOLEAN のフィールドを書き込むとき、デフォルトの ESQL ストリング "TRUE" および "FALSE" を使用します。 この使用法は、XML スキーマ 1.0 仕様に準拠していません。

    バージョン 7.0 で、XMLNSC パーサーは XML スキーマ 1.0 仕様に準拠した、"true" および "false" を書き込みます。 "true" および "false" 以外のストリングを書き込む必要がある場合、BOOLEAN フィールドを CHARACTER にキャストしてください。

  • バージョン 6.0 で、XMLNSC パーサーは、メッセージ・セットから生成された XML スキーマに照らして XML 文書を妥当性検査することはありません。

    バージョン 7.0 で、XMLNSC パーサーにはこの機能があります。 メッセージ・セットをブローカー・アーカイブ (BAR) ファイルに追加するときに、メッセージ・セットの「メッセージ・ドメイン」プロパティーが「XMLNSC」に設定されていれば、XMLNSC パーサーが使用する可能性のために、メッセージ・セット内のメッセージ定義ファイルごとに 1 つの XML スキーマ・ファイルが生成されます。 XML スキーマは、BAR ファイルがデプロイされるときに、XMLNSC パーサーによって検査されます。

    ただし、この検査はメッセージ定義ファイル・エディターによって実施される検査よりも厳格であり、デプロイメントは失敗する場合もあります。 デプロイメントが失敗した場合、メッセージ定義ファイルを XML スキーマ規則に準拠するように訂正する必要があります。 IBM® 提供の SOAP Envelope メッセージ定義ファイルの 1 つがメッセージ・セットに含まれる場合は、「IBM 提供のメッセージからの新規メッセージ定義ファイル」ウィザードを使用して、そのメッセージ定義ファイルを再インポートしてください。

MRM パーサーにおける動作の変更点

以下の変更内容は、バージョン 7.0に実装されています。

  • バージョン 6.0 では、MRM パーサー TDS 物理形式の「データ・エレメント分離」、「タグ付き固定長」、「タグ付き区切り」、および「タグ付きエンコード長」は、メッセージ・ツリーで検出された xsi:type 属性を、タグ名 "type" を使用して書き出します。

    バージョン 7.0 で、TDS 物理形式はすべての xsi:type 属性が XML 固有であると想定して、それらを書き出しません。

  • バージョン 6.0 では、MRM TDS 物理形式の「データ・エレメント分離」、「固定長」、「固定長 AL3」、「タグ付き固定長」は、TDS 長がゼロのエレメントを、構文解析のときには固定長として扱い、書き込みのときには可変長として扱います。 そのため、そのようなエレメントに対するメッセージ・ツリー内のデータはすべて、例外がスローされることなく、ビット・ストリームに書き込まれます。

    バージョン 7.0 では、エレメントは構文解析のときも書き込みのときも、固定長として扱われます。 そのため、そのようなエレメントに対するメッセージ・ツリー内のすべてのデータによりメッセージ BIP5436E が生成されます。 ただし、TDS プロパティーの「出力時に切り捨て」が設定されていればこの例外はスローされませんが、この場合には何も書き出されません。

  • バージョン 6.0 では、欠落していた必須の反復エレメント (minOccurs > 1) が、MRM メッセージを妥当性検査するときに検出された場合、メッセージ BIP5374E が生成されます。
    バージョン 7.0 では、次の 2 つの異なる状態が妥当性検査のときに検出されます。
    • 反復であっても、メッセージ・ツリー内にインスタンスがない必須エレメント。 この場合、メッセージ BIP5378E が生成され、欠落エレメントが予期される場所の前後に存在するエレメントの詳細が提供されます。 この変更のために、既存の自動エラー処理を変更または拡張する必要が生じることがあります。
    • 反復であっても、メッセージ・ツリー内のインスタンス数が正しくない必須エレメント。 この場合、前と同様にメッセージ BIP5374E が生成され、既存で予期されるエレメントのインスタンスの詳細が示されます。

汎用マイグレーション情報

以下の変更内容は、バージョン 7.0に実装されています。

  • 1 つのメッセージ・セットの中に、MRM または IDOC ドメイン用のモデルに加えて、他のドメイン (例えば XMLNSC) 用のモデルを含めることができます。 バージョン 6.0 では、メッセージ・セットが BAR ファイルに追加されるとき、MRM パーサーで使用される .dictionary ファイルが常に生成されます。

    バージョン 7.0 では、MRM または IDOC をデフォルト・メッセージ・ドメインとして指定した場合、あるいは MRM または IDOC をメッセージ・セット・ファイル内の「サポートされているメッセージ・ドメイン」に追加した場合に限り、.dictionary ファイルが生成されます。 .dictionary ファイルがもはや生成されない場合は、「サポートされているメッセージ・ドメイン」に MRM または IDOC を追加してください。

  • XML パーサーは推奨されていません。これは、将来のリリースで使用されなくなる可能性があります。 XML パーサーを使用する既存のメッセージ・フローは、バージョン 7.0 で引き続き機能します。 XMLNSC ドメインは、XML 文書の構文解析または書き込みが必要なほとんどの新しいメッセージ・フローに使用します。 詳しくは、どの XML パーサーを使用すべきかを参照してください。
  • IDOC ドメインおよびパーサーは推奨されていません。これらは、将来のリリースで使用されなくなる可能性があります。 IDOC パーサーを使用する既存のメッセージ・フローは、バージョン 7.0 で引き続き機能します。 MRM ドメインの TDS 物理形式は、構文解析が必要な、または WebSphere MQ Link for R3 から発生した SAP ALE IDoc をテキスト形式で書き出すことが必要な、新しいメッセージ・フローに使用します。
  • いくつかの MRM TDS プロパティーの場所およびラベルが更新されています。これらの変更には、動作上の変更は関係しません。
    • 「反復エレメント区切り文字」プロパティーは、すべての反復プロパティーをまとめておくために「オカレンス」というラベルのあるボックスに移動しています。
    • 「仮想小数点」および「精度」プロパティーは、プロパティー・グループ「符号」の下に移動して、CWF プロパティーと揃えられました。
    • 「長さの参照」プロパティーは、ローカル・グループ、グループ参照、および複合エレメントでは使用されず、それらのプロパティー・シートからは除去されました。
    • ローカル・グループ・プロパティー・シートには、「データ・パターン」プロパティーを他の部分から区別するための、「フィールド識別」というラベルの付いた 2 つのボックスが備えられました。これは、「データ・パターン」がグループそのものではなく、その親の中に組み込まれるものに対して適用されるためです。
    • メッセージ・セットのブール表記プロパティーは、新しいバイナリー・ブール表記プロパティーから区別するために、接頭部「テキスト」と共に表示されるようになりました。
    • 「物理タイプ」プロパティーの列挙値「文字」は、「テキスト」に名前変更されました。
    • 「物理タイプ」プロパティーの列挙値「メッセージング標準」は、「TLOG 固有」に名前変更されました。
    • 「固定長ストリングのトリム」プロパティーは、「入力時にトリム」に名前変更されて、「固定長ストリング」というラベルの付いた新しいボックスに移動しました。
    • 「デフォルトの長さを論理タイプから導き出す」プロパティーは、 「汎用設定値」というラベルの付いた新しいボックスに移動しました。
  • いくつかの MRM CWF プロパティーの場所およびラベルが更新されています。これらの変更には、動作上の変更は関係しません。
    • 「フォーマット」プロパティーは、「物理表現」セクションの最後に移動して、TDS プロパティーと揃えられました。
    • エレメント・プロパティー・シートには、「符号」プロパティー・グループと「仮想小数点」を含む 「数値表現」セクションというラベルの付いたセクションが備えられ、それらのプロパティーは TDS プロパティーと揃えられました。
    • 「長さカウント」プロパティーは「長さ」に名前変更され、このプロパティーは TDS プロパティーと揃えられています。
    • 「ストリング位置調整」プロパティーは「位置調整」に名前変更され、このプロパティーは TDS プロパティーと揃えられています。
    • 「符号 EBCDIC カスタム」プロパティーは「オーバーパンチされた符号付き EBCDIC カスタム」に名前変更され、このプロパティーは TDS プロパティーと揃えられています。
    • 「記号の方向」プロパティーの列挙値「先頭」および「末尾」は、「オーバーパンチされた先頭」および「オーバーパンチされた末尾」に名前変更され、このプロパティーは TDS プロパティーと揃えられています。
    • メッセージ・セットのバイト・オーダー・プロパティーは、接頭部「デフォルト」を伴って表示されるようになり、これらのプロパティーは TDS プロパティーと揃えられています。
特記事項 | 商標 | ダウンロード | ライブラリー | サポート | フィードバック

Copyright IBM Corporation 1999, 2012Copyright IBM Corporation 1999, 2012.

        
        最終更新
        
        最終更新 : 2012-08-03 11:54:55


タスク・トピックタスク・トピック | バージョン 7.0.0.5 | ah20250_