XSLTransform-Knoten

Der XSLTransform-Knoten wird zur Umwandlung einer XML-Nachricht in ein anderes Nachrichtenformat verwendet (hierbei gelten die Regeln, die von einer XSL-Formatvorlage (XSL = eXtensible Stylesheet Language) bereitgestellt werden). Er wird auch zum Festlegen von Nachrichtendomäne, Nachrichtengruppe, Nachrichtentyp und Nachrichtenformat für die generierte Nachricht verwendet.

Dieser Knoten wurde früher als XMLUmsetzungsknoten bezeichnet.

Dieses Thema enthält folgende Abschnitte:

Zweck

Sie haben drei Möglichkeiten zur Angabe der Adresse der Formatvorlage, die für diese Umwandlung verwendet werden soll:

  • Verwenden Sie den Inhalt der XML-Daten in der Nachricht selbst. Dadurch wird die Nachricht gemäß einer Formatvorlage, die von der Nachricht selbst definiert wird, umgewandelt.
  • Geben Sie einen Wert im LocalEnvironment-Ordner an. Sie müssen diesen Wert vor dem XSLTransform-Knoten (z. B. in einem Compute-Knoten) festlegen. Daher können Sie verschiedene Eingaben verwenden, um zu bestimmen, welche Formatvorlage für diese Nachricht verwendet werden soll - beispielsweise den Inhalt der Nachrichtendaten oder einen Wert in einer Datenbank.
  • Verwenden Sie Knoteneigenschaften. Dadurch stellen Sie sicher, dass die Umwandlung, die über diese einzelne Formatvorlage definiert wurde, auf jede von diesem Knoten verarbeitete Nachricht angewandt wird.

Für die Umwandlung wird ein XSLT-Compiler (Extensible Stylesheet Language for Transformations) verwendet, wenn die Formatvorlage nicht Teil der Nachricht ist und der Wert für die Knotencachestufe (Knoteneigenschaft Cachestufe für Formatvorlage) größer als null ist. Wenn XSLT zwischengespeichert wird, führt dies zu einer Leistungsverbesserung, da XSLT nicht bei jeder Verwendung syntaktisch analysiert wird.

Wenn zu Beginn des Hauptteils der Eingabenachricht eine XML-Codierungsdeklaration enthalten ist, wird diese Codierung vom XSLTransform-Knoten ignoriert und für die Decodierung der Nachricht immer die CodedCharSetId im Eigenschaftenordner verwendet.

Der XSLTransform-Knoten befindet sich im Ablagefach Transformation der Palette und wird in der Workbench durch folgendes Symbol dargestellt:

Symbol für XMLUmsetzungsknoten

Diesen Knoten in einem Nachrichtenfluss verwenden

Beispiel für die Verwendung dieses Knoten: Zwei Medienunternehmen, die regelmäßig Informationen austauschen. Bei einem der Unternehmen handelt es sich um einen Fernsehsender, das andere ist ein Zeitungsverlag. Obwohl identische Informationen verwendet werden, unterscheidet sich doch das verwendete Vokabular. Dieser Knoten kann ein Format in ein anderes umwandeln, indem er die Regeln der angegebenen Formatvorlage anwendet. Wenn Sie die Formatvorlage in der Nachricht angeben (entweder die XML-Daten oder die lokale Umgebung), kann derselbe Knoten beide Umwandlungen vornehmen.

Ausführliche Informationen zur Verwendung des XSLTransform-Knotens finden Sie im folgenden Beispiel: Sie können Beispiele nur anzeigen, wenn Sie das Information Center verwenden, das im Message Broker Toolkit integriert ist.

Verwendung von LocalEnvironment-Variablen zum Setzen von Eigenschaften

Dieser Knoten unterstützt eine Reihe von Nachrichtenbaumstrukturvariablen für die lokale Umgebung, mit denen Sie die in den Eigenschaften des Knotens festgelegten Werte dynamisch ändern können. In der folgenden Tabelle wird jede lokale Umgebungsvariable mit dem Namen der Knoteneigenschaft aufgeführt, den sie überschreibt.
Name der lokalen Umgebungsvariablen Name der Knoteneigenschaft
XSL.StyleSheetName Name der Formatvorlage
XSL.MessageDomain Nachrichtendomäne
XSL.MessageSet Nachrichtengruppe
XSL.MessageType Nachrichtentyp
XSL.MessageFormat Nachrichtenformat
XSL.OutputCharSet Zeichensatz
Dieser Knoten sucht den Namen der zu verwendenden Formatvorlage, indem er eine Abfrage in der folgenden Reihenfolge vornimmt:
  1. Eingabenachricht. Der Knoten durchsucht die XML-Nachrichtendaten nach Informationen zur Position der Formatvorlage. Die XML-Daten können beispielsweise Folgendes enthalten:
    <?xml-stylesheet type="text/xsl" href="foo.xsl"?>
    und 'foo.xsl' wird dann als Name der Formatvorlage verwendet.
  2. Lokale Umgebung. Falls in der Eingabenachricht kein Name für die Formatvorlage gefunden wird, durchsucht der Knoten die der Nachricht zugeordnete lokale Umgebung nach den Informationen zur Formatvorlage, die im Element 'XSL.StyleSheetName' gespeichert sind.

    Da dieser Knoten in Version 5.0 und Version 6.0 verfügbar war und das Element 'ComIbmXslXmltStylesheetname' als Name der Formatvorlage verwendet wurde, überprüft der Knoten beide Elemente. Sind beide Werte vorhanden, hat der Wert in 'XSL.StyleSheetName' Vorrang.

  3. Eigenschaften des Knotens. Wenn kein Formatvorlagenname in der Eingabenachricht oder in der lokalen Umgebung gefunden wird, verwendet der Knoten die Eigenschaften Name der Formatvorlage und Verzeichnis für Formatvorlagen zum Ermitteln der richtigen Werte.
Der Knoten sucht die Nachrichtendomäne, die Nachrichtengruppe, den Nachrichtentyp und das Nachrichtenformat, die für die Ausgabenachricht verwendet werden sollen, indem er eine Abfrage in der folgenden Reihenfolge vornimmt:
  1. Lokale Umgebung. Der Knoten durchsucht die der aktuellen Nachricht zugeordnete LocalEnvironment-Baumstruktur nach den Nachrichtendomänen-, Nachrichtengruppen-, Nachrichtentyp- und Nachrichtenformatinformationen, die in den Elementen XSL.MessageDomain, XSL.MessageSet, XSL.MessageType und XSL.MessageFormat gespeichert sind.
  2. Eigenschaften des Knotens. Wenn in diesen LocalEnvironment-Variablen keine Nachrichtendomänen-, Nachrichtengruppen-, Nachrichtentyp- oder Nachrichtenformatinformationen gefunden werden, verwendet der Knoten die Eigenschaften Nachrichtendomäne, Nachrichtengruppe, Nachrichtentyp und Nachrichtenformat, um die korrekten Werte zu ermitteln.
Wenn der Knoten die Nachrichtendomäne weder aus der Eigenschaft XSL.MessageDomain noch aus der Eigenschaft Nachrichtendomäne ermitteln kann, wird der Standardwert BLOB verwendet. Es gibt keine Standardwerte für Nachrichtengruppe, Nachrichtentyp und Nachrichtenformat.
Der Knoten sucht die Zeichensätze, die für die Ausgabenachricht verwendet werden sollen, indem er eine Abfrage in der folgenden Reihenfolge vornimmt:
  1. Lokale Umgebung. Der Knoten durchsucht die der Nachricht zugeordnete LocalEnvironment-Baumstruktur nach den Zeichensatzinformationen, die im Element 'XSL.OutputCharSet' gespeichert sind. Geben Sie beispielsweise den Wert 1208 als Zeichenfolge für dieses Element an, wenn die Ausgabe der Umwandlung in UTF-8 codiert werden soll.

    Da dieser Knoten in Version 5.0 und Version 6.0 verfügbar war und das Element 'ComIbmXslXmltOutputcharset' als Zeichensatz für die Ausgabe verwendet wurde, überprüft der Knoten beide Elemente. Sind beide Werte vorhanden, hat der Wert in 'XSL.OutputCharSet' Vorrang.

  2. Eigenschaften des Knotens. Wenn keine Zeichensatzinformationen in der lokalen Umgebung gefunden werden, verwendet der Knoten die Eigenschaft Zeichensatz, um den korrekten Wert zu bestimmen.

    Für Zeichensatz muss ein numerischer Wert festgelegt werden. Geben Sie beispielsweise den Wert 1200 ein, wenn die Ausgabe der Umwandlung in UTF-16 codiert werden soll.

Kann der Knoten den Ausgabezeichensatz nicht auf Grundlage einer dieser Quellen ermitteln, weil entweder kein Wert gesetzt ist oder die Auswahlprioritäten auf null gesetzt sind, wird der Standardwert 1208 (UTF-8) verwendet.

Wenn die Eingabe für den XSLTransform-Knoten vom XMLNSC- oder MRM-Parser generiert wird, sollten Sie verschiedene Punkte berücksichtigen. Bestimmte Informationen in XML-Dokumenten (z. B. Verarbeitungsanweisungen und Kommentare) werden vom XMLNSC-Parser gelöscht, wenn auf einem vorherigen Knoten die Eigenschaften zum Beibehalten dieser Informationen nicht entsprechend gesetzt wurden. Um sicherzustellen, dass die Nachricht vom XSLTransform-Knoten korrekt umgesetzt wird, müssen die die Eigenschaften Gemischten Inhalt beibehalten, Kommentare beibehalten und Verarbeitungsanweisung beibehalten auf dem vorherigen Knoten (z. B. einem MQInput-Knoten) korrekt gesetzt werden. Der MRM-Parser löscht auch diese Informationen, und Sie können keine Informationen für diesen Parser beibehalten. Deshalb sollten Sie die Verwendung des MRM-Parsers vermeiden, wenn Sie diese Informationen für Ihre Umsetzung benötigen.

Implementierte und nicht implementierte Formatvorlagen

Sie haben können Formatvorlagen auf zwei verschiedene Arten mit dem XSLTransform-Knoten verwenden:
Implementierte Formatvorlagen
Bei implementierten Formatvorlagen handelt es sich um Formatvorlagen, die Sie in eine Brokerarchivdatei (BAR-Datei) importieren und auf Zielsystemen implementieren. Implementierte Formatvorlagen werden vom Broker verwaltet. Eine Principal-Formatvorlage ist die Stamm-Formatvorlage, auf die in einem Nachrichtenfluss verwiesen wird. Beispielsweise muss ein Verweis auf eine Principal-Formatvorlage im Eclipse-Arbeitsbereich C:\\Projekt1\a\b.xsl als a/b.xsl (oder ./a/b.xsl) angegeben werden. Eine Principal-Formatvorlage kann auf ihre untergeordneten Formatvorlagen verweisen (diese enthalten oder importieren).
Nicht implementierte Formatvorlagen
Bei nicht implementierten Formatvorlagen handelt es sich um Formatvorlagen, die Sie an einer Position speichern, an der der XSLTransform-Knoten darauf zugreifen kann. Nicht implementierte Formatvorlagen werden nicht vom Broker verwaltet.
Der Abschnitt Style-Sheets und XML-Dateien von Version 5.0 migrieren enthält weitere Informationen hierzu.

Implementierung von implementierten Formatvorlagen oder XML-Dateien

Bevor Sie den XSLTransform-Knoten konfigurieren können, müssen Sie wissen, wie Sie mit Formatvorlagen arbeiten. Eine Formatvorlage kann sowohl auf eine andere XML-Datei als auch auf eine Formatvorlage verweisen. Verwendung von implementierten Formatvorlagen oder XML-Dateien:
  1. Stellen Sie sicher, dass die Dateien die richtigen Dateinamenerweiterungen haben.

    Bei Formatvorlagen, die implementiert werden sollen, muss die Dateierweiterung entweder .xsl oder .xslt lauten, und bei XML-Dateien, die implementiert werden sollen, muss sie .xml lauten.

  2. Importieren Sie die Dateien in den Eclipse-Arbeitsbereich.

    Importieren Sie alle Formatvorlagen und XML-Dateien, die implementiert werden sollen, in das Projekt eines Eclipse-Arbeitsbereichs. Schreiben Sie standortabhängige untergeordnete Formatvorlagen oder XML-Dateien, die implementiert werden sollen, in die richtige Verzeichnisstruktur, die relativ zu den zugehörigen übergeordneten Formatvorlagen ist. Im Eclipse-Arbeitsbereich sollten sich keine standortabhängigen untergeordneten Formatvorlagen befinden, die nicht implementiert werden sollen.

  3. Stellen Sie sicher, dass alle Verweise auf die Dateien relativ sind.

    Bei allen Verweisen auf eine implementierte Formatvorlage muss es sich unabhängig von ihrer Position um einen relativen Verweis handeln. Ein Verweis auf eine Principal-Formatvorlage muss relativ zu dem Stammverzeichnis des relevanten Projekts des Eclipse-Arbeitsbereichs sein.

    Einzige Ausnahme: Bei der Angabe einer Principal-Formatvorlage als Eigenschaft Name der Formatvorlage in einem XSLTransform-Knoten können Sie einen absoluten Pfad verwenden, der auf die richtige Verzeichnisstruktur im Eclipse-Arbeitsbereich verweist. Wenn die Principal-Formatvorlage gefunden wurde, setzt das System die Knoteneigenschaft automatisch auf den richtigen relativen Wert.

    Außerdem führt es eine automatische Implementierung der Principal-Formatvorlage und der standortabhängigen untergeordneten Formatvorlagen aus, die im relevanten Eclipse-Arbeitsbereichsprojekt verfügbar sind. Alle Verweise auf standortabhängige untergeordnete Formatvorlagen (oder XML-Dateien) einer Principal-Formatvorlage müssen relativ zum Standort der zugehörigen übergeordneten Formatvorlagen sein. Wenn beispielsweise die Formatvorlage //project1/a/b.xsl auf die Formatvorlage //project1/a/c/d.xsl verweist, muss der Verweis in c/d.xsl (oder ./c/d.xsl) geändert werden.

  4. Bearbeiten Sie nicht implementierte untergeordnete Formatvorlagen oder XML-Dateien.

    Formatvorlagen können auf andere Formatvorlagen verweisen. Wenn Sie eine Formatvorlage (oder XML-Datei) mit einem relativen Verweis haben, die selbst zwar nicht, aber deren übergeordnetes Element implementiert werden soll, müssen Sie sicherstellen, dass die untergeordnete Formatvorlage an die korrekte Position unter Arbeitspfad/XSL/external (Arbeitspfad/XML/external) gestellt wird. Dabei ist Arbeitspfad der vollständige Pfad zum Arbeitsverzeichnis des Brokers.

    Ein Broker ordnet die in der Ausführungsgruppe implementierte Speicherbaumstruktur, Arbeitspfad/XSL/external, und die Baumstruktur Arbeitspfad/XML/external einander automatisch zu. Wenn also beispielsweise das Dokument b/c.xml im implementierten Speicher des Brokers nicht gefunden wird, führt der Broker im Verzeichnis Arbeitspfad/XML/external/a/b automatisch eine Suche nach einem Verweis auf das Dokument in der implementierten Principal-Formatvorlage a/style.xsl durch. Relative Pfadverweise müssen auch für Dateien verwendet werden, die bereits implementiert wurden, die im Arbeitsbereich aber noch nicht verfügbar sind.

  5. Implementieren Sie die Dateien.

    Implementieren Sie nur die Formatvorlagen oder XML-Dateien manuell, die vom System noch nicht berücksichtigt wurden (das Message Broker Toolkit gibt Warnungen zu diesen Dateien aus). Wenn Sie für den Knoten auf Durchsuchen klicken oder den vollständigen Pfad der Formatvorlage im Eclipse-Arbeitsbereich angeben, wird dies automatisch in die BAR-Datei eingefügt.

    Fügen Sie die Dateien bei der manuellen Implementierung zu einem Brokerarchiv hinzu. Sie finden weitere Informationen hierzu in den Abschnitten Dateien zu einem Brokerarchiv hinzufügen und Schlüsselwörter zu XSL-Formatvorlagen hinzufügen.

    Für jede Ausführungsgruppe, die den XSLTransform-Knoten verwendet, führen Sie eine der folgenden Aktionen aus:
    • Fügen Sie die Formatvorlage in das Verzeichnis Arbeitspfad/XSL/external auf dem Broker ein und nicht in die BAR-Datei.

      Wenn eine Formatvorlage im Verzeichnis Arbeitspfad/XSL/external denselben Pfad und denselben Namen wie eine implementierte Formatvorlage hat, wird die implementierte Formatvorlage verwendet.

    • Fügen Sie die Formatvorlage in die BAR-Datei ein, und implementieren Sie die BAR-Datei. Wenn mehrere BAR-Dateien denselben Formatvorlagennamen enthalten, wird die Formatvorlage aus der zuletzt implementierten BAR-Datei verwendet.
    • Implementieren Sie die Formatvorlage in ihrer eigenen BAR-Datei. Wenn die BAR-Dateien XSLTransform-Knoten verwenden, jedoch nicht die Formatvorlage enthalten, gibt das Message Broker Toolkit Warnungen aus.

XSLTransform-Knoten konfigurieren

Nachdem Sie eine Instanz des XSLTransform-Knotens in einen Nachrichtenfluss eingereiht haben, können Sie ihn konfigurieren; siehe Nachrichtenflussknoten konfigurieren. Die Knoteneigenschaften werden in der Eigenschaftenansicht angezeigt.

Alle verbindlichen Eigenschaften, für die Sie einen Wert eingeben müssen (d. h. Eigenschaften ohne definierten Standardwert), sind mit einem Sternchen gekennzeichnet.

Konfigurieren Sie den XSLTransform-Knoten:

  1. Optional: Geben Sie auf der Registerkarte Beschreibung eine Kurzbeschreibung, eine ausführliche Beschreibung oder beides ein. Sie können den Knoten dort auch umbenennen.
  2. Geben Sie zum Definieren einer Formatvorlage über die Knoteneigenschaften auf der Registerkarte Formatvorlage den erforderlichen Wert für Name der Formatvorlage ein.
    Geben Sie die Principal-Formatvorlage mit einer der folgenden Methoden an:
    • Klicken Sie auf Durchsuchen neben Name der Formatvorlage. Die erkannten Principal-Formatvorlagen und alle zugehörigen untergeordneten Formatvorlagen mit relativem Verweis werden beim Hinzufügen eines Nachrichtenflusses zu einer BAR-Datei automatisch zur BAR-Datei hinzugefügt (wenn die Formatvorlagen und übergeordneten Formatvorlagen verfügbar sind).
    • Verwenden Sie zum Erkennen einer bereits implementierten oder einer zur Implementierung bereiten Formatvorlage die Eigenschaft Name der Formatvorlage, und lassen Sie die Eigenschaft Verzeichnis für Formatvorlagen leer.
    • Ziehen Sie im Nachrichtenflusseditor eine .xslt-Datei auf den XSLTransform-Knoten; daraufhin wird der Name der Formatvorlage automatisch festgelegt.
  3. Auf der untergeordneten Registerkarte Erweitert:
    1. Wurde die Position der Formatvorlage vollständig angegeben, wird die Eigenschaft Verzeichnis für Formatvorlagen nicht berücksichtigt; andernfalls wird der Wert dieser Eigenschaft am Anfang der Spezifikation eingefügt, unabhängig davon, an welcher Stelle der Wert gefunden wurde.
    2. Geben Sie für die Eigenschaft Cachestufe für Formatvorlage die Anzahl der kompilierten oder syntaktisch analysierten Formatvorlagen ein, die in der Knoteninstanz gespeichert werden sollen. Der Standardwert ist 5. Der Formatvorlagen-Cache wird während der Lebensdauer des Knotens beibehalten und erst gelöscht, wenn der Knoten aus dem Nachrichtenfluss entfernt, der Nachrichtenfluss gelöscht oder die Ausführungsgruppe gestoppt wird.

      Wenn Sie eine zwischengespeicherte Formatvorlage ändern (indem Sie die Datei im Dateisystem erneut implementieren oder ersetzen), ersetzt der XSLTransform-Knoten, der den Cache enthält, die zwischengespeicherte Version durch die geänderte (neueste) Version, bevor eine neue Nachricht verarbeitet wird. Wenn Sie mehrere Formatvorlagen ändern, sollten Sie jedoch die relevanten Nachrichtenflüsse stoppen, bevor Sie Änderungen vornehmen. Wenn Sie die relevanten Nachrichtenflüsse nicht stoppen, bevor Sie die Änderungen vornehmen, kann die Reihenfolge der Änderungen von aktiven Nachrichtenflüssen nicht garantiert werden, was eine Inkompatibilität zwischen geänderten Formatvorlagen verursachen kann. Verwenden Sie den Befehl mqsireload, um eine Formatvorlage erneut zu laden. Der Befehl verhindert die Inkompatibilität jedoch nicht.

  4. Auf der Registerkarte Output Message Parsing (Syntaxanalyse der Ausgabenachricht):
    1. Um der Ausgabenachricht einen bestimmten Parser zuzuordnen, geben Sie die neue Domäne in der Eigenschaft Nachrichtendomäne an. Der Standardwert lautet BLOB. Diese Domäne wird für die Ausgabenachricht angewendet. Verwenden Sie alternativ Übernehmen, um den Parser zuzuordnen, der die Eingabenachricht hatte.
      • MRM
      • XMLNSC
      • XMLNS
      • DataObject
      • JMSMap
      • JMSStream
      • MIME
      • BLOB (Binary large object)
      • XML (veraltet - verwenden Sie XMLNSC)
      • Übernehmen

      Sie können bei Bedarf auch einen benutzerdefinierten Parser angeben.

    2. Wenn Sie den MRM-Parser oder den XMLNSC-Parser im Prüfungsmodus verwenden, wählen Sie die Nachrichtengruppe aus, die verwendet werden soll. Diese Liste wird mit den verfügbaren Nachrichtengruppen gefüllt, wenn Sie MRM oder XMLNSC als Domäne auswählen.
    3. Wenn Sie den MRM-Parser verwenden, wählen Sie aus der Liste unter Nachrichtentyp die korrekte Nachricht aus. Diese Liste wird mit Nachrichten aufgefüllt, die in der von Ihnen ausgewählten Nachrichtengruppe definiert sind.
    4. Wenn Sie den MRM-Parser verwenden, wählen Sie aus der Liste unter Nachrichtenformat das gewünschte physische XML-Format für die Ausgabenachricht aus. Diese Liste enthält alle physischen Formate, die Sie für diese Nachrichtengruppe definiert haben.
    5. Um einen Zeichensatz für die Ausgabenachricht unter Verwendung von Knoteneigenschaften anzugeben, geben Sie den erforderlichen Wert für Zeichensatz an. Sie müssen einen numerischen Wert festlegen; geben Sie beispielsweise den Wert 1200 ein, wenn die Ausgabenachricht in UTF-16 codiert werden soll.
  5. Auf der untergeordneten Registerkarte Parser-Optionen gilt Folgendes:
    1. Die Option Zeitpunkt für Syntaxanalyse ist standardmäßig auf Bei Bedarf gesetzt. Dies führt dazu, dass die Syntaxanalyse der Nachricht verzögert wird. Der Abschnitt Bedarfsgerechte Syntaxanalyse enthält Informationen zur sofortigen Analyse von Nachrichten.
    2. Legen Sie bei Verwendung des XMLNSC-Parsers Werte für die Eigenschaften fest, die die Funktionsweise des XMLNSC-Parsers bestimmen. Der Abschnitt Nachrichten in der XMLNSC-Domäne bearbeiten enthält weitere Informationen hierzu.
  6. Legen Sie auf der Registerkarte Auswertung die Auswertungseigenschaften fest, damit der Parser den Hauptteil von Nachrichten anhand der Nachrichtengruppe überprüft. (Wenn eine Nachricht an das Fehlerterminal des Knotens übergeben wird, wird sie nicht ausgewertet.)

    Weitere Informationen finden Sie unter Nachrichten überprüfen und Auswertungseigenschaften.

  7. Legen Sie auf der Registerkarte Detail-Trace die Traceeinstellung so fest, dass die Aktionen des XSLTransform-Knotens nachverfolgt werden. Standardwert ist Off. Zum Aktivieren des Trace setzen Sie die Eigenschaft auf On.

    Die Tracedaten werden in der Tracedatei XMLTTrace.log gespeichert:

    • z/OS platform Auf z/OS-Systemen befindet sich die Datei im Verzeichnis Installationsverzeichnis/output, wobei Installationsverzeichnis für das Verzeichnis steht, in dem der Broker installiert ist.
    • Windows platform Auf Windows-Systemen befindet sich die Datei im Verzeichnis workpath\log, wenn Sie die Option -w des Befehls mqsicreatebroker angegeben haben. Wenn Sie den Brokerarbeitspfad nicht angegeben haben, werden die Daten in das Verzeichnis C:\Dokumente und Einstellungen\All Users\Application Data\IBM\MQSI\common\log geschrieben.
    • Linux platform UNIX platform Auf Linux- und UNIX-Systemen befindet sich die Datei im Verzeichnis /var/mqsi/common/log.

    Wenn Sie Traceeinstellung für einen XSLTransform-Knoten auf On setzen, wird diese Einstellung für alle Knoten in der Ausführungsgruppe übernommen.

    Diese Eigenschaft wird nicht mehr unterstützt. Jeder relevante Trace wird in den Benutzertrace verschoben, vorausgesetzt, der Debug-Benutzertrace ist aktiviert. Die Einstellung von Traceeinstellung im XSLTransform-Knoten wirkt sich nicht auf Benutzertraces aus.

Wird in Zusammenhang mit umfangreichen XML-Nachrichten der Fehler Speicherknappheit gemeldet, kann der aktuelle Wert des Java-Heapspeichers für die XSLT-Steuerkomponente mit Hilfe des Befehls mqsireportproperties angezeigt werden:
mqsireportproperties Brokername -e Kennung_der_Ausführungsgruppe -o ComIbmJVMManager -n jvmMaxHeapSize
Verwenden Sie den Befehl mqsichangeproperties, um die Größe des Java-Heapspeichers zu erhöhen:
mqsichangeproperties Brokername -e Kennung_der_Ausführungsgruppe -o ComIbmJVMManager -n jvmMaxHeapSize -v Neue_Größe
Ersetzen Sie in den zuvor genannten Beispielen Brokername, Kennung_der_Ausführungsgruppe und Neue_Größe durch die entsprechenden Werte.

Der Wert für Neue_Größe richtet sich nach der Größe des physischen Hauptspeichers Ihres Computers sowie danach, wie häufig Sie Java verwenden. Ein Wert zwischen 512 MB (536870912) und 1 GB (1073741824) ist in der Regel ausreichend.

Terminals und Eigenschaften

In der folgenden Tabelle werden die XSLTransform-Knotenterminals beschrieben .

Terminal Beschreibung:
Eingangsterminal Das Eingangsterminal, das die Nachricht zur Verarbeitung durch einen Knoten annimmt.
Fehlerterminal Das Ausgabeterminal, an das die Originalnachricht weitergeleitet wird, wenn während der Umwandlung ein Fehler auftritt.
Ausgabeterminal Das Ausgabeterminal, an das eine erfolgreich umgewandelte Nachricht weitergeleitet wird.

In den folgenden Tabellen werden die Knoteneigenschaften beschrieben. Die Spalte M zeigt an, ob die Eigenschaft obligatorisch ist (markiert mit einem Sternchen, wenn ein Wert eingegeben werden muss, weil kein Standardwert definiert ist). Die Spalte C zeigt an, ob die Eigenschaft konfigurierbar ist (Wert kann geändert werden, wenn der Nachrichtenfluss zur BAR-Datei hinzugefügt wird, um ihn einzusetzen).

In der folgenden Tabelle werden die Beschreibungseigenschaften des XSLTransform-Knotens beschrieben.

Eigenschaft M C Standardwert Beschreibung:
Knotenname Nein Nein Knotentyp Der Name des Knotens.
Kurzbeschreibung Nein Nein   Kurze Beschreibung des Knotens
Ausführliche Beschreibung Nein Nein   Text, der den Zweck des Knotens im Nachrichtenfluss beschreibt

In der folgenden Tabelle werden die Formatvorlageneigenschaften des XSLTransform-Knotens beschrieben.

Eigenschaft M C Standardwert Beschreibung:
Name der Formatvorlage Nein Ja   Der Name der Formatvorlage; wird beim Suchen der Spezifikation für die Formatvorlage in den Knoteneigenschaften verwendet.

In der folgenden Tabelle werden die erweiterten Eigenschaften des XSLTransform-Knotens beschrieben.

Eigenschaft M C Standardwert Beschreibung:
Verzeichnis der Formatvorlage Nein Ja   Der Pfad der Formatvorlage. Er wird von allen Positionierungsmethode verwendet.
Cachestufe für Formatvorlage Nein Nein 5 Die Anzahl der kompilierten oder syntaktisch analysierten Formatvorlagen, die in der Knoteninstanz gespeichert werden.

In der nachfolgenden Tabelle werden die Eigenschaften für die Syntaxanalyse der Ausgabenachricht des XSLTransform-Knotens beschrieben.

Eigenschaft M C Standardwert Beschreibung:
Nachrichtendomäne Nein Nein BLOB Die Nachrichtendomäne, die mit der Ausgabenachricht verknüpft ist.
Nachrichtengruppe Nein Nein   Die Nachrichtengruppe, die mit der Ausgabenachricht verknüpft ist.
Nachrichtentyp Nein Nein   Der Nachrichtentyp, der mit der Ausgabenachricht verknüpft ist.
Nachrichtenformat Nein Nein   Das Nachrichtenformat, das mit der Ausgabenachricht verknüpft ist.
Zeichensatz Nein Nein   Der numerische Wert des Zeichensatzes für die Ausgabenachricht

In der folgenden Tabelle werden die Parseroptionen des XSLTransform-Knotens beschrieben.

Eigenschaft M C Standardwert Beschreibung:
Zeitpunkt für Syntaxanalyse Nein Nein Bei Bedarf Durch diese Eigenschaft wird gesteuert, zu welchem Zeitpunkt eine Ausgabenachricht syntaktisch analysiert wird. Gültige Werte sind Bei Bedarf, Sofort und Vollständig.

Eine vollständige Beschreibung der bedarfsgesteuerten Syntaxanalyse finden Sie unter Bedarfsgerechte Syntaxanalyse.

Baumstruktur unter Verwendung von XML-Schemadatentypen erstellen Nein Nein Nicht ausgewählt Über diese Eigenschaft wird gesteuert, ob der XMLNSC-Parser Syntaxelemente in der Nachrichtenbaumstruktur mit Datentypen aus dem XML-Schema erstellt. Sie können diese Eigenschaft nur auswählen, wenn Sie Auswerten auf Inhalt oder Inhalt und Wert gesetzt haben.
XMLNSC-Kompaktparser für XMLNS-Domäne verwenden Nein Nein Nein Durch diese Eigenschaft wird gesteuert, ob der XMLNSC-Kompaktparser für Ausgabenachrichten in der XMLNS-Domäne verwendet wird. Wenn Sie diese Eigenschaft festlegen, werden die Nachrichtendaten unter XMLNSC in Knoten, die mit dem Ausgabeterminal verbunden sind, angezeigt, wenn der MQRFH2-Header oder die Domäne XMLNS ist.

In der folgenden Tabelle werden die Auswertungseigenschaften des XSLTransform-Knotens beschrieben. Eine umfassende Beschreibung zu Auswertungseigenschaften finden Sie unter Auswertungseigenschaften.

Eigenschaft M C Standardwert Beschreibung:
Auswertung Nein Ja Keines Durch diese Eigenschaft wird gesteuert, ob eine Auswertung der Ausgabenachricht stattfindet. Gültige Werte sind Keine, Inhalt, Inhalt und Wert und Übernehmen.
Aktion bei Fehler Nein Nein Ausnahme Durch diese Eigenschaft wird gesteuert, was beim Fehlschlagen der Auswertung der Ausgabenachricht geschieht. Sie können diese Eigenschaft nur angeben, wenn Sie Auswerten auf Inhalt und Wert oder auf Inhalt gesetzt haben. Gültige Werte sind Benutzertrace, Lokales Fehlerprotokoll, Ausnahmebedingung und Ausnahmeliste.

In der folgenden Tabelle werden die Detail-Trace-Eigenschaften des XSLTransform-Knotens beschrieben.

Eigenschaft M C Standardwert Beschreibung:
Trace-Einstellung Ja Nein Off Über diese Eigenschaft wird gesteuert, ob die Tracefunktion aktiv oder inaktiv ist. Ist sie aktiv, werden Tracedaten mit niedriger Detailtiefe in einer Datei gespeichert.
Bemerkungen | Marken | Downloads | Bibliothek | Unterstützung | Rückmeldung
Copyright IBM Corporation 1999, 2007 Letzte Aktualisierung: Jan 24, 2008
ac12490_