Nachrichtengruppenmigration

Überprüfen Sie bei der Migration eines Nachrichtenflusses, der Nachrichtengruppen verwendet, die Änderungen des Verhaltens in WebSphere Message Broker Version 7.0.

Lesen Sie diese Informationen zu Änderungen an Nachrichtengruppen und möglichen Auswirkungen, wenn Sie die Migration von Version 6.0 vornehmen; aus Version 6.1 ist keine Migration der Nachrichtengruppe erforderlich.

Sie müssen keine Migrationsbefehle ausführen; das WebSphere Message Broker Toolkit Version 7.0 kann ein Version 6.0-Nachrichtengruppenprojekt lesen und automatisch in das Version 7.0-Format konvertieren, wenn Sie es zum ersten Mal ändern und speichern.

Die folgenden Abschnitte enthalten Anleitungen für Änderungen des Verhaltens von Parsern sowie allgemeine Migrationsinformationen:

Änderungen im Verhalten des XMLNSC-Parsers

Die folgenden Änderungen werden in Version 7.0 implementiert:

  • In Version 6.0 werden die Attribute eines XML-Elements in der Reihenfolge in die vom XMLNSC-Parser erstellte Nachrichtenbaumstruktur aufgenommen, in der sie in dem Element im XML-Dokument stehen.

    In Version 7.0 zeigt der XMLNSC-Parser beim Erstellen der Nachrichtenbaumstruktur immer Namespaceattribute vor anderen Attributen an. Da es bei XML-Attributen jedoch keine feste Reihenfolge gibt, sollte beim Erstellen einer Nachrichtenflusslogik nicht von bestimmten Attributpositionen ausgegangen werden.

  • In Version 6.0 akzeptiert der XMLNSC-Parser EBCDIC-NEL nur unter z/OS als XML-Zeilenvorschubzeichen.

    In Version 7.0 wird NEL auf allen Plattformen akzeptiert.

  • In Version 6.0 ignoriert der XMLNSC-Parser die Eigenschaft Auswerten eines Knotens.

    In Version 7.0 beachtet der XMLNSC-Parser die Eigenschaft Auswerten. Wenn Sie diese Eigenschaft auf Inhalt oder Inhalt und Wert setzen, wertet der Parser die Nachricht anhand der in der Eigenschaft Nachrichtengruppe definierten Nachrichtengruppe aus.

    Deshalb löst der Nachrichtenfluss nach der Migration auf Version 7.0 eine Ausnahmebedingung aus, falls Sie die Eigenschaft Auswerten in Version 6.0 unbeabsichtigt auf Inhalt oder Inhalt und Wert gesetzt haben.

    Sie können diese Situation korrigieren, indem Sie die Eigenschaft Auswerten auf Keine setzen.

  • In Version 6.0 verwendet der XMLNSC-Parser das ESQL-Standardformat 'JJJJ-MM-TT hh:mm:ss', wenn er Daten in ein Feld des Typs TIMESTAMP oder GMTTIMESTAMP schreibt. Dieses Format entspricht nicht der Spezifikation von XML-Schema 1.0.

    In Version 7.0 verwendet der XMLNSC-Parser das Format 'JJJJ-MM-TT'T'hh:mm:ss.sss', das der Spezifikation von XML Schema 1.0 entspricht. Falls ein anderes Format gespeichert werden muss, müssen Sie das TIMESTAMP- bzw. GMTTIMESTAMP-Feld in ein CHARACTER-Feld umsetzen. (Wenn das Element ursprünglich vom XMLNSC-Parser ausgewertet wurde und eine Zeitzonenangabe enthielt, wird auch die Zeitzonenangabe in das Ausgabenachrichtenfeld geschrieben.)

  • In Version 6.0 verwendet der XMLNSC-Parser die ESQL-Standardzeichenfolgen 'TRUE' und 'FALSE', wenn er Daten in ein Feld des Typs BOOLEAN schreibt. Dies entspricht nicht der Spezifikation von XML-Schema 1.0.

    In Version 7.0 schreibt der XMLNSC-Parser 'true' und 'false', was der Spezifikation von XML Schema 1.0 entspricht. Wenn Sie andere Zeichenfolgen als 'true' und 'false' speichern müssen, setzen Sie das BOOLEAN-Feld in ein CHARACTER-Feld um.

  • In Version 6.0 wertet der XMLNSC-Parser XML-Dokumente nicht anhand eines von einer Nachrichtengruppe generierten XML-Schemas aus.

    In Version 7.0 bietet der XMLNSC-Parser diese Option. Wenn Sie eine Nachrichtengruppe zu einer Brokerarchivdatei (BAR-Datei) hinzufügen und die Eigenschaft Nachrichtendomäne der Nachrichtengruppe auf XMLNSC gesetzt ist, wird für jede Nachrichtendefinitionsdatei in der Nachrichtengruppe ein XML-Schema generiert, das bei Bedarf vom XMLNSC-Parser verwendet werden kann. Diese XML-Schemas werden bei der Implementierung der BAR-Datei vom XMLNSC-Parser überprüft.

    Diese Überprüfung ist jedoch strenger als die Überprüfungen, die im Editor für die Nachrichtendefinitionsdatei durchgeführt werden, so dass die Implementierung fehlschlagen kann. Falls die Implementierung fehlschlägt, müssen Sie die Nachrichtendefinitionsdatei korrigieren, damit sie den Regeln des XML-Schemas entspricht. Wenn die Nachrichtengruppe eine der IBM® eigenen SOAP-Envelope-Nachrichtendefinitionsdateien enthält, führen Sie einen erneuten Import mithilfe des Assistenten 'Neue Nachrichtendefinitionsdatei aus einer IBM eigenen Nachricht' durch.

Änderungen im Verhalten des MRM-Parsers

Die folgenden Änderungen werden in Version 7.0 implementiert:

  • In Version 6.0 gibt der MRM-Parser beim physischen TDS-Format mit den Datenelementtrennzeichen 'Mit Kennung/fester Länge', 'Mit Kennung/Begrenzer' und 'Mit Kennung/codierter Länge' jedes in der Nachrichtenbaumstruktur gefundene Attribut 'xsi:type' mit dem Attributnamen 'type' aus.

    In Version 7.0 wird beim physischen TDS-Format davon ausgegangen, dass alle 'xsi:type'-Attribute XML-spezifisch sind. Deshalb werden sie nicht ausgegeben.

  • In Version 6.0 behandelt der MRM-Parser beim physischen TDS-Format mit den Datenelementtrennzeichen 'Mit Kennung/fester Länge', 'Mit Kennung/Begrenzer' und 'Mit Kennung/codierter Länge' ein Element mit einer TDS-Länge von null beim Parsen wie ein Element mit fester Länge, bei der Ausgabe jedoch wie ein Element mit variabler Länge. Deshalb werden alle Daten in der Nachrichtenbaumstruktur für ein solches Element in einen Bitstrom geschrieben, ohne dass eine Ausnahmebedingung ausgelöst wird.

    In Version 7.0 wird das Element beim Parsen und bei der Ausgabe wie ein Element mit fester Länge behandelt. Deshalb haben alle Daten in der Nachrichtenbaumstruktur für ein solches Element zur Folge, dass die Nachricht BIP5436E generiert wird, es sei denn, Sie haben die TDS-Eigenschaft Bei Ausgabe abschneiden festgelegt. In diesem Fall erfolgt keine Ausgabe.

  • In Version 6.0 wird die Nachricht BIP5374E generiert, wenn während der Auswertung einer MRM-Nachricht erkannt wird, dass ein verbindliches, sich wiederholendes Element (minOccurs > 1) fehlt.
    In Version 7.0 werden während der Auswertung zwei verschiedene Bedingungen erkannt:
    • Ein verbindliches Element, das wiederholt wird, von dem in der Nachrichtenbaumstruktur aber keine Instanzen vorkommen. In diesem Fall wird die Nachricht BIP5378E generiert, die Details zu den Elementen liefert, die vor und hinter der erwarteten Position des fehlenden Elements stehen. Wegen dieser Änderung müssen Sie möglicherweise automatisierte Fehlerprozesse, die Sie einsetzen, ändern oder erweitern.
    • Ein verbindliches Element, das wiederholt wird und von dem in der Nachrichtenbaumstruktur die richtige Anzahl Instanzen vorkommt. In diesem Fall wird die Nachricht BIP5374E generiert, die Details zu den vorhandenen und erwarteten Instanzen des Elements enthält.

Allgemeine Migrationsinformationen

Die folgenden Änderungen werden in Version 7.0 implementiert:

  • Eine einzelne Nachrichtengruppe kann Modelle für MRM- oder IDOC-Domänen sowie für andere Domänen wie beispielsweise XMLNSC enthalten. In Version 6.0 wird immer eine .dictionary-Datei für die Verwendung durch den MRM-Parser generiert, wenn die Nachrichtengruppe einer BAR-Datei hinzugefügt wird.

    In Version 7.0 wird eine .dictionary-Datei nur generiert, wenn MRM oder IDOC als Standardnachrichtendomäne angegeben oder MRM oder IDOC in der Nachrichtengruppendatei zu Unterstützte Nachrichtendomänen hinzugefügt wurden. Wenn keine .dictionary-Datei mehr generiert wird, fügen Sie MRM oder IDOC den Unterstützten Nachrichtendomänen hinzu.

  • Der XML-Parser ist veraltet und wird möglicherweise in einem künftigen Release zurückgezogen. Bestehende Nachrichtenflüsse, die den XML-Parser verwenden, funktionieren auch in Version 7.0. Verwenden Sie für neue Nachrichtenflüsse, in denen XML-Dokumente ausgewertet oder geschrieben werden müssen, die XMLNSC-Domäne. Der Abschnitt Auswahl des geeigneten XML-Parsers enthält weitere Informationen hierzu.
  • Die IDOC-Domäne und der zugehörige Parser sind veraltet und werden möglicherweise in einem künftigen Release zurückgezogen. Bestehende Nachrichtenflüsse, die den IDOC-Parser verwenden, funktionieren auch in Version 7.0. Verwenden Sie das physische TDS-Format der MRM-Domäne für neue Nachrichtenflüsse, in denen SAP-ALE-IDocs ausgewertet und in einem Textformat geschrieben werden müssen, das aus WebSphere MQ link for R3 stammt.
  • Die Position und Bezeichnung einiger MRM-TDS-Eigenschaften wurden aktualisiert; diese Änderungen haben keine Auswirkungen auf das Verhalten der Eigenschaften.
    • Die Eigenschaft Begrenzer für Wiederholelemente wurde in ein Fenster mit dem Namen "Vorkommen" verschoben, um alle Eigenschaften in Bezug auf Wiederholungen zusammenzuführen.
    • Die Eigenschaften Virtuelles Dezimalzeichen und Genauigkeit werden unter die Eigenschaftengruppe "Sign" (Vorzeichen) verschoben, um sie an den CWF-Eigenschaften auszurichten.
    • Die Eigenschaft Längenverweis wurde für lokale Gruppen, Gruppenverweise und komplexe Elemente nicht verwendet und deshalb aus ihren Eigenschaftenblättern entfernt.
    • Das Eigenschaftenblatt für lokale Gruppen enthält jetzt zwei Kästchen mit dem Namen "Feldidentifikation", um die Eigenschaft Datenmuster von den übrigen zu unterscheiden, weil sich Datenmuster nicht auf die Gruppe selbst bezieht, sondern auf ihre Einbindung in das ihr übergeordnete Element.
    • Die Nachrichtengruppeneigenschaften für boolesche Darstellung werden jetzt mit dem Präfix "Text" angezeigt, um sie von neuen Eigenschaften für binäre boolesche Darstellung zu unterscheiden.
    • Der Aufzählungswert Zeichen für die Eigenschaft Physischer Typ wurde in Text umbenannt.
    • Der Aufzählungswert Alternativer Nachrichtenstandard für die Eigenschaft Physischer Typ wurde in TLOG-spezifisch umbenannt.
    • Die Eigenschaft Zeichenfolge mit fester Länge abschneiden wurde in Bei Ausgabe abschneiden umbenannt und in das neue Fenster mit dem Namen "Zeichenfolgen mit fester Länge" verschoben.
    • Die Eigenschaft Standardlänge von logischem Typ ableiten wurde in ein neues Fenster mit dem Namen "Allgemeine Einstellungen" verschoben.
  • Die Position und Bezeichnung einiger MRM-CWF-Eigenschaften wurden aktualisiert; diese Änderungen haben keine Auswirkungen auf das Verhalten der Eigenschaften.
    • Die Eigenschaft Format wurde als letzter Eintrag in den Abschnitt "Physische Darstellung" verschoben, um sie an den TDS-Eigenschaften auszurichten.
    • Das Eigenschaftenblatt für Elemente enthält jetzt einen Abschnitt mit dem Namen "Numerische Darstellung", in dem sich die Gruppeneigenschaften für Vorzeichen und 'Virtueller Dezimalpunkt' befinden, um diese Eigenschaften an den TDS-Eigenschaften auszurichten.
    • Die Eigenschaft Längenzähler wurde in Länge umbenannt, um sie an den TDS-Eigenschaften auszurichten.
    • Die Eigenschaft Ausrichtung der Zeichenfolge wurde in Ausrichtung umbenannt, um sie an den TDS-Eigenschaften auszurichten.
    • Die Eigenschaft Sign EBCDIC Custom wurde in Vorzeichen angepasste EBCDIC-Überlochung umbenannt, um sie an den TDS-Eigenschaften auszurichten.
    • Die Aufzählungswerte Führend und Abschließend der Eigenschaft Vorzeichenausrichtung wurden in Führender Überlochungswert und Abschließender Überlochungswert umbenannt, um sie an den TDS-Eigenschaften auszurichten.
    • Die Eigenschaften für die Byteanordnung in Nachrichtengruppen werden jetzt mit dem Präfix "Default" (Standard) angezeigt, um sie an den TDS-Eigenschaften auszurichten.
Bemerkungen | Marken | Downloads | Bibliothek | Support | Feedback

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

        
        Letzte Aktualisierung
        
        Letzte Aktualisierung : 2012-08-06 17:57:24


TaskthemaTaskthema | Version 7.0.0.5 | ah20250_