CWF-Eigenschaften von Nachrichtengruppen

In der nachfolgenden Tabelle werden die Eigenschafen erläutert, die Sie für die Nachrichtengruppe einrichten können. Einige der Nachrichtengruppeneigenschaften (gekennzeichnet mit einem Sternchen (*)) sind nur von Bedeutung, wenn die Nachricht, die verarbeitet wird, nicht WebSphere MQ als Transportprotokoll verwendet. Wenn das Transportprotokoll WebSphere MQ verwendet wird, werden Werte aus den Nachrichtenheadern abgeleitet (z. B. MQMD) und die Eigenschaften der Nachrichtengruppe werden, falls eingerichtet, ignoriert.

Binäre Darstellung von Booleschen Werten

Eigenschaft Typ Bedeutung
Boolescher Wert TRUE Zeichenfolge Geben Sie maximal acht hexadezimale Ziffern ein. Schließen Sie nicht den Hexadezimal-Anzeiger (0x) mit ein, der vor dieser Zahl steht. Jede Ziffer hat eine Länge von einem halben Byte. Die maximale Länge beträgt 4 Byte. Sie müssen eine gerade Zahl von Stellen eingeben (ganzzahlige Byte). Dieser Wert muss sich vom Booleschen Wert 'False' unterscheiden, aber dieselbe Länge haben. Der Standardwert lautet 00000001.
Boolescher Wert FALSE Zeichenfolge Geben Sie maximal acht hexadezimale Ziffern ein. Schließen Sie nicht den Hexadezimal-Anzeiger (0x) mit ein, der vor dieser Zahl steht. Jede Ziffer hat eine Länge von einem halben Byte. Die maximale Länge beträgt 4 Byte. Sie müssen eine gerade Zahl von Stellen eingeben (ganzzahlige Byte). Dieser Wert muss sich vom Booleschen Wert 'True' unterscheiden, aber dieselbe Länge haben. Der Standardwert lautet 00000000.
Boolescher Nullwert Zeichenfolge Geben Sie maximal acht hexadezimale Ziffern ein. Schließen Sie nicht den Hexadezimal-Anzeiger (0x) mit ein, der vor dieser Zahl steht. Jede Ziffer hat eine Länge von einem halben Byte. Die maximale Länge beträgt 4 Byte. Sie müssen eine gerade Zahl von Stellen eingeben (ganzzahlige Byte). Dieser Wert kann mit dem Booleschen Wert 'Value' und dem Booleschen Wert 'False' übereinstimmen, darf aber auch abweichen. Der Standardwert lautet 00000000.

Ausgabeeinstellungen

Diese Einstellungen werden verwendet, wenn Nachrichten serialisiert werden.

Eigenschaft Typ Bedeutung
Füllzeichen bei Byteausrichtung Zeichenfolge Wenn die xsd:element CWF-Eigenschaften Byteausrichtung, Zu überspringende führende Bytes und Zu überspringende anschließende Bytes dazu führen, dass Byte beim Serialisieren von Nachrichten im Bitstrom ausgelassen werden, liefert diese Eigenschaft das Zeichen, das an den ausgelassenen Positionen verwendet werden soll. Dieses Zeichen kann wie folgt gesetzt werden:
  • Wählen Sie aus der Dropdown-Liste die Optionen SPACE, NUL oder 0 (Standardwert) aus.
  • Geben Sie ein in Anführungszeichen gesetztes Zeichen an, beispielsweise "c" oder 'c'; dabei steht 'c' für ein beliebiges alphanumerisches Zeichen.
  • Geben Sie einen dezimalen Zeichencode ein, beispielsweise in der Form YY. Dabei steht YY für einen Dezimalwert.
  • Geben Sie einen hexadezimalen Zeichencode ein, beispielsweise 0xYY; dabei steht YY für einen Hexadezimalwert.
  • Geben Sie einen Unicode-Wert im Format 'U+xxxx' ein; dabei steht xxxxxx für einen Unicode-Wert im Hexadezimalformat.
Richtlinie für fehlende Elemente Aufgezählter Typ Die Einstellung dieser Eigenschaft regelt die Aktionen des Brokers, wenn beim Serialisieren der Nachricht Felder in der Nachrichtenbaumstruktur fehlen:
  • Verwenden Sie den Standardwert (Standardeinstellung). Wenn ein Standardwert für das Element existiert, geben Sie au oder lösen Sie anderenfalls eine Ausnahme aus.
  • Verwenden Sie den Nullwert. Wenn die Eigenschaft Nullwerte möglich des Elements geprüft und ein Parameterwert der Nullwertcodierung für das Element angegeben wird, geben Sie den Parameterwert der Nullwertcodierung entsprechend den von der Eigenschaft Nullwertcodierung definierten Regeln aus. Anderenfalls wird eine Ausnahmebedingung ausgelöst.

Binäre Darstellung von Dezimalwerten

Eigenschaft Typ Bedeutung
Code für gepackt dezimale positive Zahl Aufgezählter Typ Wählen Sie aus der Dropdown-Liste das positive Vorzeichen aus, das für gepackte Dezimalzahlen verwendet wird. Der Standardwert lautet C. Das bedeutet, dass der übliche Wert 0x0C als positives Vorzeichen verwendet wird. Sie können auch F auswählen. Es zeigt an, dass 0x0F als positives Vorzeichen verwendet wird (einige Systeme erfordern diese Einstellung).

Datums-/Zeiteinstellungen

Eigenschaft Typ Bedeutung
Standardformat für Datum/Zeit vom logischen Typ ableiten Schaltfläche Wählen Sie diese Option aus, wenn der Standardwert für das Datums-/Zeitformat anhand des logischen Typ des Elements oder Attributs bestimmt werden soll. Folgende Standardwerte stehen zur Verfügung:
Datums-/Zeitformat
jjjj-MM-tt'Z'HH:mm:ssZZZ
Datum
jjjj-MM-tt
Zeit
HH:mm:ssZZZ
gJahr
jjjj
gJahrMonat
jjjj-MM
gMonat
--MM--
gMonatTag
--MM-dd
gTag
---dd

Innerhalb eines komplexen Typs können Sie diese Eigenschaft für ein Element oder Attribut überschreiben.

Standardformat für Datum/Zeit verwenden Schaltfläche und Datums-/Zeitformat Wählen Sie diese Option aus, wenn Sie ein festes Datums-/Zeitformat für alle Elemente oder Attribute des logischen Typs Datum/Zeit, Datum, Zeit, gJahr, gJahrMonat, gMonat, gMonatTag und gTag verwenden möchten.

Der Anfangswert für diese Eigenschaft ist JJJJ-MM-TT'T'HH:mm:ssZZZ; dieser Wert kann überschrieben werden.

Innerhalb eines komplexen Typs können Sie diese Eigenschaft für ein Element oder Attribut überschreiben.

Weitere Informationen zu Datums-/Zeitformaten finden Sie unter Datum-/Zeitformate.

Beginn der Datumsangaben mit zweistelliger Jahreszahl Integer Diese Eigenschaft gibt an, wie zweistellige Jahreszahlen interpretiert werden. Geben Sie die beiden Zahlen für den Beginn eines hundertjährigen Zeitfensters an, innerhalb dessen das aktuelle Jahr liegt. Wenn Sie beispielsweise 89 angeben und das aktuelle Jahr das Jahr 2002 ist, werden alle zweistelligen Jahresangaben als im Bereich zwischen 1989 und 2088 liegend interpretiert.

Der Anfangswert ist 53; er kann überschrieben werden.

Tage in der ersten Woche im Jahr Aufgezählter Typ Geben Sie die Anzahl Tage an, die auf die erste Woche im neuen Jahr fallen sollen.

Das Beginn eines neuen Jahres liegt häufig in der Mitte der Woche. Ist die Anzahl der Tage in dieser Woche kleiner als der hier angegebene Wert, wird die Woche als die letzte Woche im alten Jahr interpretiert; die erste Woche im neuen Jahr beginnt daher unter der Woche. Ist die Anzahl der Tage in dieser größer als der hier angegebene Wert, wird die Woche als erste Woche im neuen Jahr interpretiert; die erste Woche im neuen Jahr beginnt daher einige Tage vor Beginn des neuen Jahres.

Wählen Sie Brokerländereinstellungen verwenden, so dass der Broker die Information aus der verwendeten Plattform abruft, oder wählen Sie in der Dropdown-Liste eine Zahl aus. Der Anfangswert ist 4.

Erster Wochentag Aufgezählter Typ Geben Sie den Tag an, mit dem die neue Woche beginnen soll.

Wählen Sie Brokerländereinstellungen verwenden, so dass der Broker die Informationen aus der Plattform abruft, oder wählen Sie in der Dropdown-Liste einen Wert aus. Der Anfangswert ist Montag.

Strict DateTime Checking (Strikte Datums-/Zeitprüfung) Kontrollkästchen Wählen Sie dieses Option, wenn die Datums-/Zeitangabe auf ein gültiges Datums-/Zeitformat beschränkt werden soll. Dadurch wird nicht gestattet, beispielsweise den 35. März als 4. April und die Zeitangabe 10:79 Uhr als 11:19 zu interpretieren. Bei Auswahl der Option Strict DateTime Checking (Strikte Datums/Zeitprüfung) wird beim Empfang unzulässiger Datums-/Zeitformat eine Fehlernachricht generiert. Standardmäßig wird das Datums-/Zeitformat beschränkt.
Strikte Datums-/Zeitprüfung
Beispiele für strikte Datums-/Zeitprüfung:
  • Das Datums/Uhrzeit-Format ist auf gültige Datums- und Uhrzeitangaben eingeschränkt. Das heißt, dass beispielsweise das Datum 35. März nicht als 4. April und die Zeitangabe 10:79 Uhr nicht als 11:19 interpretiert werden kann. Wenn solche Datums-/Uhrzeitangaben empfangen werden, führt dies zu einem Fehler.
  • Die Anzahl der Zeichen für eine numerische Datums-/Zeitkomponente muss sich innerhalb der Grenzen der entsprechenden Formatierungssymbole befinden. Wiederholen Sie das Symbol, um die Mindestanzahl der erforderlichen Ziffern anzugeben. Die maximale Anzahl zulässiger Ziffern ist die Obergrenze für ein bestimmtes Symbol. Beispiel: 'Tag im Monat' hat die Obergrenze 31, weshalb eine Formatierzeichenfolge von 'd' die Werte von 2 oder 21 zum Parsen zulässt, aber den Wert 32 oder 210 nicht. Bei der Ausgabe werden Zahlen mit Nullen auf die angegebene Länge aufgefüllt. Ein Jahr ist ein Sonderfall (s. Nachrichtengruppeneigenschaft von Beginn der Datumsangaben mit zweistelliger Jahreszahl). Bei Sekundenbruchteilen muss die Länge implizit der Anzahl an Formatsymbolen bei der Eingabe entsprechen. Die Ausgabe wird auf die angegebene Länge gerundet.
  • Leerzeichen werden nicht übersprungen. Die Leerzeichen in der Eingabezeichenfolge müssen in Anzahl und Position den Leerzeichen in der Formatierungszeichenfolge entsprechen.
  • Falls in der Eingabezeichenfolge noch Daten ausgewertet werden müssen, nachdem alle Symbole in der Formatierungszeichenfolge abgeglichen worden sind, führt dies zu einem Fehler.
Ungenaue Datums-/Zeitprüfung
Beispiele für ungenaue Datums-/Zeitprüfung:
  • Der Parser wandelt ungültige Werte für Datum und Uhrzeit in den jeweils entsprechenden gültigen Wert um. Zum Beispiel wird die Datumsangabe 2005-05-32 in das Datum 2005-06-01 umgewandelt.
  • Die Ausgabe von Datum-/Uhrzeitangaben entspricht immer der Anzahl der Symbole. Beispiel: Die Formatierzeichenfolge yyyy-MM-dd (wobei '-' das Feldtrennzeichen ist) lässt das syntaktische Analysieren eines oder mehrerer Zeichen gemäß 'MM' und 'dd' zu. Dies würde die Eingabe von ungültigen Datumsangaben wie 2005-1-123 oder 2005-011-12 zulassen. Der erste Wert 2005-1-123 würde als das Datum 2005-05-03 ausgegeben, und der zweite Wert 2005-011-12 würde als das Datum 2005-11-12 ausgegeben.
  • Die Anzahl des Zeitzonenformatierungssymbols Z ist nur für die Ausgabe des Datum/Uhrzeit-Formats gültig.
  • Leerzeichen werden übersprungen.
Zeitzone Aufgezählter Typ Der für diese Eigenschaft gesetzte Wert wird verwendet, wenn der für die Eigenschaft Standardformat für Datum/Zeit angegebene Wert keine Angabe zur Zeitzone enthält.

Der Anfangswert ist Brokerländereinstellungen verwenden, so dass der Broker die Information aus der verwendeten Plattform abruft.

Dieser Wert kann über das Dropdown-Feld geändert werden.

Sommerzeit Kontrollkästchen Wählen Sie diese Option, wenn in der über die Eigenschaft Zeitzone Gegend die Sommerzeit gilt. Ist dies nicht der Fall, sollte diese Option nicht gewählt werden.

Wird über Zeitzone eine Region ausgewählt, ohne diese Option ('Sommerzeit') ebenfalls auszuwählen, wird in der Zeitzone keine Sommerzeit berücksichtigt.

Standardmäßig wird die Sommerzeit nicht berücksichtigt.

UTC-Eingabeformat für die Ausgabe verwenden Kontrollkästchen Diese Eigenschaft gilt für Elemente und Attribute des logischen Typs xsd:dateTime bzw. xsd:time, die eine Datums-/Zeitangabe in Form einer Zeichenfolge enthalten und ein Datum/Uhrzeit-Format I, IU, T oder TU besitzen bzw. ZZZ oder ZZZU einschließen.

Solche Elemente und Attribute können die UTC-Zeit (Consolidated Universal Time) angeben, indem im Wert entweder das Zeichen Z oder die Zeitzone +00:00 verwendet wird. Bei der Eingabe erkennt der MRM-Parser die Art und Weise, in der die UTC-Zeit angegeben wurde, wieder.

Wenn diese Eigenschaft aktiviert ist und das Element oder Attribut in eine Ausgabenachricht kopiert wird, wird das UTC-Format unverändert in die Ausgabenachricht übernommen und überschreibt das durch die Datum/Uhrzeit-Formateigenschaft implizierte Format.

Wenn diese Eigenschaft nicht aktiviert ist oder das Element oder Attribut nicht aus einer Eingabenachricht kopiert wurde, wird das UTC-Format in der Ausgabenachricht allein durch die Datum/Uhrzeit-Formateigenschaft gesteuert.

Diese Eigenschaft ist standardmäßig inaktiviert.

Zeichenverschlüsselung und numerische Verschlüsselung für Nicht-WebSphere MQ-Nachrichten

Diese Einstellungen werden nur für Nachrichten ohne MQMD verwendet.

Eigenschaft Typ Bedeutung
Standard-CCSID* INTEGER Geben Sie einen numerischen Wert für die Standard-CCSID ein. Der Standardwert lautet 500.

Wenn die Eingabenachricht eine WebSphere MQ-Nachricht ist, wird das entsprechende Attribut für den Warteschlangenmanager verwendet und diese Eigenschaft ignoriert.

Byteanordnung* Aufgezählter Typ Wählen Sie entweder Big Endian (die Standardeinstellung) oder Little Endian aus der Dropdown-Liste aus, um die Byteanordnung der Zahlen festzulegen, die als binäre Ganzzahlen dargestellt werden.

In C entspricht dies dem Datentyp SHORT bzw. LONG. Die entsprechenden COBOL-Datentypen lauten PIC 9 COMP, COMP-4, COMP-5 oder BINARY.

Ihre Auswahl muss der Codierung entsprechen, mit der die Nachrichten erstellt werden. Für gewöhnlich ist Big Endian die geeignete Option für Nachrichten, die unter UNIX oder z/OS erstellt wurden, Little Endian wird bei Windows ausgewählt.

Diese Eigenschaft wird nicht verwendet, wenn die Nachricht über das WebSphere MQ-Transportprotokoll empfangen wurde: in diesem Fall wird die Eigenschaft aus der MQMD der Nachricht oder aus der Codierung des Broker-Warteschlangenmanagers abgerufen.

Gepackt dezimale Byteanordnung* Aufgezählter Typ Wählen Sie entweder Big Endian (die Standardeinstellung) oder Little Endian aus der Dropdown-Liste aus, um die Byteanordnung der Zahlen festzulegen, die als gepackte Dezimalzahlen dargestellt werden. In COBOL entspricht dies dem Datentyp PIC 9 COMP-3. (In C gibt es keinen entsprechenden Datentyp.)

Ihre Auswahl muss der Codierung entsprechen, mit der die Nachrichten erstellt werden. Für gewöhnlich ist Big Endian die geeignete Option für Nachrichten, die unter UNIX oder z/OS erstellt wurden, Little Endian wird bei Windows NT ausgewählt.

Gleitkommaformat* Aufgezählter Typ Wählen Sie S390 (Standardeinstellung), IEEE oder IEEE-Umkehrung aus der Dropdown-Liste aus, um die Byteanordnung der Zahlen in der Nachricht festzulegen, die als Gleitkomma dargestellt werden.
Zugehörige Konzepte
Physische Formate in der MRM-Domäne
Angepasstes physisches Format (CWF)
Custom Wire Format (CWF): Beziehung zum logischen Modell
Zugehörige Tasks
Mit physischen Merkmalen arbeiten
Zugehörige Verweise
Nachrichtenmodellverweisinformationen
Nachrichtengruppeneigenschaften
Physische XML-Eigenschaften von Nachrichtengruppen
TDS-Formateigenschaften von Nachrichtengruppen
Bemerkungen | Marken | Downloads | Bibliothek | Unterstützung | Rückmeldung
Copyright IBM Corporation 1999, 2006 Letzte Aktualisierung: 23. Aug. 2006
ad09255_