WebSphere Message Broker Version 8.0.0.5 Betriebssysteme: AIX, HP-Itanium, Linux, Solaris, Windows, z/OS

Sehen Sie sich die Informationen zur aktuellen Produktversion im IBM Integration Bus Version 9.0 an.

Nachrichtengruppen: CWF-Eigenschaften für Elementverweise und lokale Elemente des Datum/Zeit-Typs

Physische CWF-Formateigenschaften für Elementverweise und lokale Elemente des Datum-/Zeit-Typs.

Die nachfolgend beschriebenen CWF-Eigenschaften gelten für:

Physische Darstellung

Eigenschaft Typ Bedeutung
Physischer Typ Aufgezählter Typ Wählen Sie einen Typ aus der angezeigten Liste aus:
  • Zeichenfolge mit fester Länge. Die Länge des Elements wird durch andere, nachfolgend beschriebene Längeneigenschaften bestimmt.
  • Codierte Zeichenfolgelänge 1. Das erste Byte des Elements gibt die Länge der Zeichenfolge nach dem Längenbyte in Längeneinheiten an. Die maximale Länge eines Elements mit der Länge Codierte Zeichenfolgelänge 1 beträgt 255 Längeneinheiten.
  • Codierte Zeichenfolgelänge 2. Die ersten beiden Bytes des Elements geben die Länge der Zeichenfolge nach den beiden Längenbytes in Längeneinheiten an. Die maximale Länge eines Elements mit der Länge Codierte Zeichenfolgelänge 2 beträgt 65535 Längeneinheiten. Die beiden Längenbytes haben das Codierungsformat des WebSphere MQ-Warteschlangenmanagers.
  • Zeichenfolge mit null am Ende. Die Zeichenfolge endet mit dem Hexadezimalzeichen für NULL X'00'.
  • Gepackt dezimal. Datum/Zeit-Angaben sind als gepackte Dezimalzahl codiert. Diese Zahl ist nur gültig, wenn die Eigenschaft Datum/Zeit-Format nur numerische Daten vorgibt.
  • Binär. Datum/Zeit-Angaben werden als binäre Bytesequenz codiert. Wenn Sie diese Option auswählen, stehen Ihnen für die Eigenschaft 'Formatierzeichenfolge' weniger Symbole zur Auswahl als bei einer Zeichenfolgeoption (siehe Nachrichtengruppen: Datum/Zeit-Formate).
  • Zeit in Sekunden. Dieser Wert unterstützt das C-Objekt time_t sowie Datums- und Zeitobjekte von Java™. Diese Zahl ist nur gültig, wenn die Eigenschaft Datum/Zeit-Format nur numerische Daten vorgibt.
  • Zeit in Millisekunden. Dieser Wert unterstützt das C-Objekt time_t sowie Datums- und Zeitobjekte von Java. Der Wert ist nur gültig, wenn die Eigenschaft Datum/Zeit-Format nur numerische Daten vorgibt.

Der Standardwert ist Zeichenfolge mit fester Länge.

Länge Schaltfläche und Integer Wenn Sie Zeichenfolge mit fester Länge, Gepackt dezimal oder Binär als Physischer Typ ausgewählt haben und die Länge durch die Eigenschaft Länge definiert werden soll, geben Sie die Anzahl der Längeneinheiten für das Element ein.

Der Mindestwert aller drei physischen Typen ist 1.

Der Maximalwert für Zeichenfolge mit fester Länge ist 256. Für Gepackt dezimal ist der Maximalwert 10 und für Binär ist der Maximalwert 2147483647.

Der Standardwert ist 0 (null).

Längenverweis Schaltfläche und aufgezählter Typ Wenn Sie festgelegt haben, dass die Länge durch einen Längenverweis bestimmt wird, wählen Sie den Namen des ganzzahligen Objekts aus, das die Länge des aktuellen Objekts bestimmt. Treffen Sie Ihre Auswahl in der angezeigten Liste der ganzzahligen Objekte, die dem aktuellen Objekt gleichgeordnet sind und in der Nachrichtenstruktur vor diesem Objekt vorkommen.

Informationen zur Änderung der Elementreihenfolge finden Sie unter Nachrichtengruppen: Objekte umordnen.

Einschließender Längenverweis Kontrollkästchen Diese Eigenschaft ist nur gültig, wenn Längenverweis festgelegt ist.

Wenn das Kontrollkästchen aktiviert ist, entspricht der Wert des gleichgeordneten ganzzahligen Objekts, das durch Längenverweis identifiziert wird, der Länge des aktuellen Objekts zuzüglich der Länge des gleichgeordneten ganzzahligen Objekts.

Wenn das Kontrollkästchen nicht aktiviert ist, entspricht der Wert des gleichgeordneten ganzzahligen Objekts, das durch Längenverweis identifiziert wird, lediglich der Länge des aktuellen Objekts.

Wenn das Kontrollkästchen aktiviert ist, muss die Eigenschaft Längeneinheiten des gleichgeordneten ganzzahligen Objekts mit der des aktuellen Objekts identisch sein.

Längeneinheiten Aufgezählter Typ Wählen Sie die Längeneinheit für das Element oder Attribut aus. Wählen Sie in der angezeigten Liste eine der folgenden Optionen aus (bei einigen physischen Typen stehen nicht alle Optionen zur Auswahl):
  • Bytes. Die Länge wird in Bytes angegeben.
  • Zeichen. Die Länge wird in Zeichen angegeben. Das bedeutet, dass die Anzahl der Bytes, die im Bitstrom verarbeitet wird, von der Codepage der zu verarbeitenden Zeichen abhängt.
    • Bei einer Einzelbyte-Codepage (CCSID 'SBCS') wie z. B. "latin-1" (CCSID 850) entspricht die Anzahl der Bytes der Anzahl der Zeichen.
    • Bei einer Doppelbyte-Codepage (CCSID 'DBCS') wie z. B. "UTF-16" (CCSID 1200) ist der Anzahl der Bytes doppelt so hoch wie die Anzahl der Zeichen.
    • Bei einer Mehrfachbyte-Codepage (CCSID 'MBCS') wie z. B. "UTF-8" (CCSID 1208) hängt die Anzahl der Bytes vom Inhalt des Bitstroms ab. Der Parser liest jeweils ein Zeichen ein und untersucht, ob das Zeichen aus einem oder mehreren Bytes besteht.
  • Zeicheneinheiten. Diese Option gibt an, dass die Größe der jeweiligen Zeichen (in Byte) über die Codepage der Nachricht bestimmt wird.
    • Bei Single-Byte- und Doppelbyte-Codepages entspricht diese Option der Option Zeichen.
    • Durch Auswahl dieser Option wird bei Verwendung einer Mehrfachbyte-Codepage die Analyseleistung optimiert, da in diesem Fall davon ausgegangen wird, dass jedes Zeichen in der kleinsten Zeicheneinheit, die von der Codepage unterstützt wird, codiert ist. Dies bedeutet jedoch, dass eine Nachricht ausschließlich diese Zeichen enthalten darf. Andernfalls wird sie nicht ordnungsgemäß verarbeitet. Beispiel: Bei der Codepage "UTF-8" (CCSID 1208) ist die kleinste Zeicheneinheit ein Byte, daher kann der Parser in einem einzigen Lesevorgang (bei dem er die Anzahl der über die Eigenschaft Länge angegebenen Bytes liest) die gesamte Nachricht abrufen. In der Nachricht dürfen nur Zeichen enthalten Sie, die in 1-Byte-Einheiten codiert sind.
  • Ende des Bitstroms. Alle Daten bis zum Ende des Bitstroms werden verarbeitet. Diese Option ist nur gültig, wenn das Element das letzte Element der Nachricht ist. Wenn Sie diese Option auswählen, brauchen Sie für die Eigenschaft Längenzähler oder Längenverweis keinen Wert einzugeben.

Der Standardwert ist Bytes.

Ausrichtung Aufgezählter Typ Wenn der physische Typ Zeichenfolge mit fester Länge ist, wählen Sie in der Dropdown-Liste Linksbündig ausrichten (Standard) oder Rechtsbündig ausrichten . Wenn Sie einen anderen Wert für Physischer Typ ausgewählt haben, ist diese Eigenschaft inaktiv.
Auffüllzeichen String

Wenn Sie die Eigenschaft Physischer Typ auf Zeichenfolge mit fester Länge eingestellt haben und die Eigenschaft Ausrichtung auf Linksbündig ausrichten oder Rechtsbündig ausrichten gesetzt ist, stellen Sie dieses Zeichen wie folgt ein:

Wenn die Zeichenfolge kürzer als die durch die Eigenschaften Länge oder Längenverweis angegebene Zeichenfolgenlänge ist, werden die verbleibenden Stellen mit dem Auffüllzeichen gefüllt. Ob die Zeichenfolge von links oder von rechts aufgefüllt wird, legt die Eigenschaft Ausrichtung fest.

Bei der Syntaxanalyse einer Eingabenachricht wird das Auffüllzeichen vom Ende der Zeichenfolge her gekürzt. Ob die Zeichenfolge von links oder von rechts gekürzt wird, legt die Eigenschaft Ausrichtung fest.

Dieses Zeichen kann wie folgt angegeben werden:

  • Wählen Sie in der angezeigten Liste NUL, '0' oder SPACE aus.
  • Geben Sie ein Zeichen in Anführungszeichen ein; zum Beispiel "c" oder 'c', wobei c jedes beliebige alphanumerische Zeichen sein kann.
  • Geben Sie einen Unicode-Wert in der Form U+xxxx ein, wobei xxxx ein hexadezimal angegebener Unicode-Wert ist. Die Maximallänge der Zeichenfolge ist 10.
  • Geben Sie einen hexadezimalen Zeichencode ein, beispielsweise 0xYY; dabei steht YY für einen Hexadezimalwert.
  • Geben Sie einen dezimalen Bytewert ein (zwischen 0 und 255).

Für welche Füllzeichenart Sie sich bei MRM-Elementen entscheiden, hängt davon ab, welches Auffüllzeichen erforderlich ist und ob das Auffüllzeichen konvertiert werden muss. In den meisten Fällen reicht es völlig aus, ein Auffüllzeichen in Anführungszeichen zu definieren. Wenn dieses Auffüllzeichen benötigt wird, wird es automatisch in die Ziel-Codepage der generierten MRM-Ausgabenachricht konvertiert. Wenn Sie beispielsweise U+0008 als Auffüllzeichen definiert haben, wird dieses Zeichen bei einer Konvertierung von ASCII in Codepage 500 von 0x08 in 0x15 konvertiert (dies sind die ASCII- und EBCDIC-Darstellungen der Rücksetztaste).

Ist ein Auffüllzeichen notwendig, das nicht ohne weiteres in das entsprechende Feld eingegeben werden kann, kann das Zeichen als mnemonisches Zeichen im Unicode-Format angegeben werden. Auch Unicode-Werte werden in die Ziel-Codepage der generierten MRM-Ausgabenachricht konvertiert.

Wenn eine Nachricht von einer Codepage in eine andere konvertiert wird, müssen Sie sicherstellen, dass der konvertierte Wert des Auffüllzeichens auch in der Ziel-Codepage gültig ist. Kann das Auffüllzeichen nicht in der Ziel-Codepage dargestellt werden, wird es durch ein Substitutionszeichen ersetzt. Das Substitutionszeichen ist festgelegt, und sein Wert richtet sich nach der angegebenen Ziel-Codepage.

Bei Auffüllzeichen, die nicht konvertiert werden müssen, kann auch das Hexadezimalformat verwendet werden. Sie haben dann die Möglichkeit, einen absoluten Wert als Auffüllzeichen zu definieren, das direkt in die Ausgabenachricht eingefügt wird. Bei Verwendung dieses Formats müssen Sie sicherstellen, dass dieser Wert für die Codepage sämtlicher Ausgabenachrichten gültig ist, die unter Verwendung dieser MRM-Definitionen erstellt werden.

Datum/Zeit-Format String Geben Sie eine Vorlage für das Datum und die Uhrzeit an.

Das Standardformat für Datum und Zeit ist vom logischen Typ des Objekts abhängig. Informationen zu den Standardwerten für die Datum/Zeit-Angabe je nach logischem Typ finden Sie unter Nachrichtengruppen: Datum/Zeit-Standardwerte nach logischem Typ.

Allgemeine Informationen zu Datums- und Zeitformaten finden Sie unter Nachrichtengruppen: Datum/Zeit-Formate.

Numerische Darstellung

Eigenschaft Typ Bedeutung
Mit Vorzeichen Kontrollkästchen Geben Sie an, ob der Wert ein Vorzeichen hat.

Diese Eigenschaft ist nur gültig, wenn die Eigenschaft Physischer Typ auf Gepackt dezimal gesetzt ist. Dieses Kontrollkästchen ist standardmäßig inaktiviert, d. h., der Wert hat kein Vorzeichen.

Darstellung von Nullwerten

Eigenschaft Typ Bedeutung
Nullwertcodierung Aufgezählter Typ Wählen Sie in der angezeigten Liste eine der nachfolgend aufgeführten Optionen aus. Mit diesen Optionen legen Sie fest, welcher Wert für die Eigenschaft Parameterwert der Nullwertcodierung eingestellt werden muss.
  • NULLPadFill. Diese Option ist nur gültig, wenn Physischer Typ auf Zeichenfolge mit fester Länge gesetzt ist. Das Feld wird mit dem unter Auffüllzeichen festgelegten Zeichen aufgefüllt. Dies ist der Standardwert.
  • NULLLogicalValue. Der Wert der Eigenschaft Parameterwert der Nullwertcodierung wird zunächst in einen tatsächlichen Wert konvertiert und danach in der für dieses Feld festgelegten Art dargestellt.
  • NULLLiteralValue. Diese Eigenschaft legt fest, dass der Parameterwert der Nullwertcodierung wie eine Zeichenfolge direkt ersetzt wird. Verwenden Sie diese Option, wenn Sie mit dem Parameterwert der Nullwertcodierung ein Nulldatum festlegen möchten, der Wert aber kein Datum/Zeit-Wert ist oder nicht mit dem Standardformat für Datum/Zeit-Angaben (jjjj-MM-tt 'T'HH:mm:ss) übereinstimmt.
  • NULLLiteralFill. Das Feld wird mit dem unter Parameterwert der Nullwertcodierung festgelegten Wert aufgefüllt. Die Eigenschaft Parameterwert der Nullwertcodierung muss sich zu einem einzigen Zeichen auflösen lassen.
Parameterwert für Nullwertcodierung String

Wenn die Eigenschaft Nullwertcodierung auf NULLPadFill gesetzt wird, ist diese Eigenschaft inaktiviert.

Wenn die Nullwertcodierung NULLLogicalValue ist, müssen Sie für diese Eigenschaft ein ISO8601-Datum/Zeit-Format einstellen. Diese Formate werden unter Nachrichtengruppen: Datum/Zeit als Zeichenfolgedaten beschrieben. Geben Sie beispielsweise einen Wert im Format jjjj-MM-tt'T'HH:mm:ss ein, zum Beispiel 1970-12-01.

Bei der Nullwertcodierung NULLLiteralValue können Sie jeden Wert eingeben, solange er die gleiche Länge wie das Feld hat.

Bei der Nullwertcodierung NULLLiteralFill muss sich der Wert zu einem einzigen Zeichen auflösen lassen. Dieses Zeichen können Sie auf eine der folgenden Arten festlegen:
  • Wählen Sie in der angezeigten Liste SPACE, NUL, 0x00 oder 0xFF aus.
  • Geben Sie ein Zeichen in Anführungszeichen ein, zum Beispiel 'c' oder "c", wobei c jedes beliebige alphanumerische Zeichen sein kann.
  • Geben Sie einen Hexadezimalzeichencode in der Form 0xYY ein, wobei YY ein Hexadezimalwert ist.
  • Geben Sie einen Dezimalzeichencode in der Form YY ein, wobei YY ein Dezimalwert ist.
  • Geben Sie einen Unicode-Wert in der Form U+xxxx ein, wobei xxxx ein hexadezimal angegebener Unicode-Wert ist.

Byte-Ausrichtung

Eigenschaft Typ Bedeutung
Byte-Ausrichtung Aufgezählter Typ Geben Sie an, wie das Objekt vom Beginn der Nachricht an ausgerichtet wird. Zur Auswahl stehen:
  • 1 Byte. Dies ist der Standardwert.
  • 2 Byte
  • 4 Byte
  • 8 Byte
  • 16 Byte
Zu überspringende führende Bytes Ganzzahl Geben Sie die Anzahl der Bytes an, die vor dem Lesen oder Schreiben des Objekts übersprungen werden sollen. Der Standardwert ist 0, der Mindestwert ist 0 und der Maximalwert ist 999999. Mit diesem Wert können Sie Felder ignorieren, die in einer Struktur unerwünscht sind, oder ein in C oder COBOL definiertes Feld modellieren, für das eine Ausrichtung an der Bytegrenze 2, 4, 8 oder 16 erforderlich ist. Geben Sie die Anzahl der Bytes an, die vor dem Lesen oder Schreiben des Objekts übersprungen werden sollen. Wenn eine Ausgabenachricht erstellt wird, wird der Anzahl der zu überspringenden Bytes der für die Nachrichtengruppe festgelegte Wert der Eigenschaft "Füllzeichen bei Byteausrichtung" zugewiesen.

Bei sich wiederholenden Objekten wird diese Eigenschaft nur der ersten Objektinstanz zugewiesen.

Zu überspringende abschließende Bytes Ganzzahl Geben Sie die Anzahl der Bytes an, die nach dem Lesen oder Schreiben des Objekts übersprungen werden sollen. Der Standardwert ist 0, der Mindestwert ist 0 und der Maximalwert ist 999999. Mit diesem Wert können Sie Felder ignorieren, die in einer Struktur unerwünscht sind, oder eine sich wiederholende Struktur modellieren, für deren Felder eine Ausrichtung an der Bytegrenze 2, 4, 8 oder 16 erforderlich ist. Wenn eine Ausgabenachricht erstellt wird, wird der Anzahl der zu überspringenden Bytes der für die Nachrichtengruppe festgelegte Wert der Eigenschaft "Füllzeichen bei Byteausrichtung" zugewiesen.

Bei sich wiederholenden Objekten wird diese Eigenschaft allen Objektinstanzen zugewiesen.

Vorkommen

Eigenschaft Typ Bedeutung
Wiederholungsverweis Aufgezählter Typ Verwenden Sie diese Eigenschaft, wenn das Objekt mehrfach vorkommt und die Häufigkeit durch ein an früherer Stelle in der Nachricht stehendes Feld dynamisch angegeben wird. Wählen Sie ein ganzzahliges Objekt aus der angezeigten Liste mit den ganzzahligen Objekten aus, die in der Struktur der Nachricht vor diesem Objekt stehen. Der Wert der ausgewählten Ganzzahl gibt die Häufigkeit dieses Objekts an. Falls keine Objekte aufgelistet sind, stehen in der Nachrichtenstruktur keine ganzzahligen Objekte vor diesem Objekt.

Wenn ein Wiederholungsverweis angegeben ist, überschreibt er alle Einstellungen für die logische Eigenschaft Maximale Anzahl beim Analysieren und Schreiben der Nachricht, aber nicht bei der Gültigkeitsprüfung der Nachricht.

Bemerkungen | Marken | Downloads | Bibliothek | Support | Feedback

Copyright IBM Corporation 1999, 2014Copyright IBM Corporation 1999, 2014.

        
        Letzte Aktualisierung:
        
        Letzte Aktualisierung: 2015-02-28 16:20:56


ReferenzthemaReferenzthema | Version 8.0.0.5 | ad15370_