CWF-Eigenschaften für Verbundelemente des Gleitkomma-Typs

Die nachfolgend beschriebenen CWF-Eigenschaften gelten für:

Physische Darstellung

Eigenschaft Typ Beschreibung
Physischer Typ Aufgezählter Typ Wählen Sie in der Dropdownliste eine der folgenden Optionen aus:
  • Integer. Dies entspricht den C-Datentypen SHORT oder LONG bzw. den numerischen COBOL-Datentypen COMP, COMP-4, COMP-5, oder BINARY.
  • Gleitkommazahl. Dies entspricht den C-Datentypen FLOAT oder DOUBLE bzw. den COBOL-Datentypen COMP-1 oder COMP-2. Dies ist der Standardwert.
  • Gepackt dezimal. Dies entspricht dem COBOL-Datentyp COMP-3.
  • Extern dezimal. Dies entspricht dem COBOL-Datentyp PIC 9 USAGE DISPLAY.

Die Darstellung numerischer Elemente kann durch die im WebSphere MQ-Warteschlangenmanager festgelegten Attribute "Encoding" und "CodedCharSetId" beeinflusst werden:

  • Elemente mit dem physischen Typ Integer, Gepackt dezimal und Gleitkommazahl werden mit dem entsprechenden WebSphere MQ-Codierungswert dargestellt.
  • Elemente mit dem physischen Typ Extern dezimal werden mit dem CodedCharSetId-Wert von WebSphere MQ dargestellt.
Längenzähler Integer Geben Sie die Elementlänge in Byte an:
  • Wenn der physische Typ Gleitkommazahl ist, wählen Sie einen Wert aus der Dropdownliste aus. Der Standardwert ist 8.
  • Wenn der physische Typ Integer ist, wählen Sie aus der Dropdownliste den Wert 1, 2 oder 4 (Standardwert) aus.
  • Wenn der physische Typ Gepackt dezimal ist, geben Sie einen Wert zwischen 1 und 10 ein.
  • Wenn der physische Typ Erweitert dezimal ist, geben Sie einen Wert zwischen 1 und 256 ein. (Bei Zahlen über der COBOL PICTURE-Maximalklausel von 18 wird der Wert 18 verwendet.)
Längeneinheiten Aufgezählter Typ Wählen Sie in der Dropdownliste je nach Physischem Typ eine der folgenden Optionen aus:
  • Bytes.
  • Zeichen. Die Bedeutung dieser Option hängt von dem Wert ab, den Sie in der CCSID (ID des codierten Zeichensatzes) der Nachricht bzw. in der Eigenschaft Standard-CCSID der Nachrichtengruppe festgelegt haben.
    • Wenn Sie als CCSID "SBCS" festgelegt haben, werden x Bytes verarbeitet, wobei x der Wert von Längenzähler bzw. des ganzzahligen Werts von Längenverweis ist.
    • Wenn Sie als CCSID "DBCS" festgelegt haben, werden y Bytes verarbeitet, wobei y der Wert von Längenzähler bzw. des ganzzahligen Werts von Längenverweis multipliziert mit 2 ist.
    • Wenn Sie als CCSID "MBCS" festgelegt haben, liest der Parser jeweils ein Zeichen ein und untersucht, ob das Zeichen aus einem oder mehreren Bytes besteht. Der Parser führt z Lesevorgänge aus, wobei z der Wert von Längenzähler bzw. des ganzzahligen Werts von Längenverweis ist.
  • Zeicheneinheiten. Wenn diese Option ausgewählt ist, wird die Größe der Zeicheneinheit durch den Wert bestimmt, den Sie in der CSID (ID des codierten Zeichensatzes) der Nachricht bzw. in der Eigenschaft Standard-CCSID der Nachrichtengruppe festgelegt haben. Die Anzahl der verarbeiteten Bytes entspricht der Größe der Zeicheneinheit multipliziert mit dem Wert von Längenzähler bzw. multipliziert mit dem ganzzahligen Wert von Längenverweis.
  • 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 Längenzähler.

Der Standardwert ist Bytes.

Mit Vorzeichen Boolescher Wert Aktivieren oder deaktivieren Sie diese Eigenschaft ("Deaktiviert", d. h. ohne Vorzeichen, ist die Standardeinstellung). Wenn der physische Typ Gleitkommazahl ist, ist diese Eigenschaft aktiviert. Diese Eigenschaft wird in Kombination mit der Eigenschaft Vorzeichenausrichtung verwendet.
Sign EBCDIC Custom Boolescher Wert Wenn der physische Typ Extern dezimal ist und die Eigenschaft Signed EBCDIC Custom ausgewählt ist, wird in einer ASCII-Umgebung die Darstellung "Sign EBCDIC Custom" verwendet. Wenn das Kontrollkästchen inaktiviert ist (Standardeinstellung), wird die Darstellung "Sign ASCII" verwendet.

Das Kontrollkästchen Sign EBCDIC Custom sollte nur dann aktiviert werden, wenn die Eigenschaft Vorzeichenausrichtung auf Führend oder Abschließend eingestellt ist (nur dann verfügt das Element bzw. Attribut über eine Vorzeichendarstellung).

Das Markierungsfeld wird inaktiviert, wenn das Element bzw. Attribut über kein Vorzeichen verfügt (z. B., wenn das Markierungsfeld Mit Vorzeichen inaktiviert ist).

Vorzeichenausrichtung Aufgezählter Typ Wenn der physische Typ Extern dezimal ist und die Option Mit Vorzeichen ausgewählt ist, wählen Sie entsprechend den jeweiligen COBOL-Optionen eine der folgenden Optionen zur Darstellung von numerischen Daten aus:
  • Eingeschlossenes führendes Vorzeichen. Bei negativen Zahlen wird ein Bit des ersten Bytes aktiviert. Bei positiven Zahlen wird keine Einstellung vorgenommen. Die ASCII-Hexadezimaldarstellung der Zahl 22 ist zum Beispiel x'3232'. Wenn diese Option aktiviert ist, wird die Zahl +22 durch x'3232' und die Zahl -22 durch x'7232' dargestellt. Dies ist der Standardwert.
  • Zusätzliches führendes Vorzeichen. Bei positiven Zahlen wird das erste Byte des Elements auf '+' gesetzt, bei negativen Zahlen auf '-'. Wenn diese Option ausgewählt ist, muss die Länge ein Vorzeichenbyte enthalten.
  • Eingeschlossenes abschließendes Vorzeichen. Bei negativen Zahlen wird ein Bit des letzten Bytes aktiviert. Bei positiven Zahlen wird keine Einstellung vorgenommen. Wenn diese Option aktiviert ist, wird die Zahl +22 durch x'3232' und die Zahl -22 durch x'3272' dargestellt.
  • Zusätzliches abschließendes Vorzeichen. Bei positiven Zahlen wird das letzte Byte des Elements auf '+' gesetzt, bei negativen Zahlen auf '-'. Wenn diese Option ausgewählt ist, muss die Länge ein Vorzeichenbyte enthalten.
Bei allen anderen physischen Typen wird automatisch der Wert 'Nicht gültig' eingestellt.
Virtuelles Dezimalzeichen Integer Geben Sie für positive Werte links und für negative Werte rechts die Anzahl der Stellen an, um die das Dezimalzeichen von seiner angenommenen Position verschoben werden soll. Das Gleitkommaelement 1234 lautet bei dem virtuellen Dezimalzeichen 3 beispielsweise 1,234.

Bei dem physischen Typ Gleitkommazahl ist diese Option nicht gültig.

Ausrichtung der Zeichenfolge Aufgezählter Typ Wenn der physische Typ Extern dezimal ist, wählen Sie in der Dropdownliste Linksbündig ausrichten oder Rechtsbündig ausrichten (Standard) aus. Bei allen anderen physischen Typen ist diese Eigenschaft unwirksam.
Auffüllzeichen Zeichenfolge Wenn die Zeichenfolge kürzer als die angegebene Zeichenfolgenlänge ist, werden die verbleibenden Stellen mit dem Auffüllzeichen gefüllt. Wenn Sie die Eigenschaft Physischer Typ auf Erweitert dezimal eingestellt haben und die Eigenschaft Ausrichtung der Zeichenfolge Linksbündig ausrichten oder Rechtsbündig ausrichten ist, stellen Sie dieses Zeichen wie folgt ein:
  • Wählen Sie in der Dropdownliste 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 zu definieren. Wenn dieses Zeichen 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 in diesem Fall also die Möglichkeit, einen absoluten Wert als Auffüllzeichen zu definieren, das direkt in die Ausgabenachricht eingefügt wird. Wenn Sie dieses Format verwenden, müssen Sie allerdings sicherstellen, dass es für die Codepage aller Ausgabenachrichten gültig ist, die mit Hilfe dieser MRM-Definitionen erstellt werden.

Darstellung von Nullwerten

Eigenschaft Typ Beschreibung
Nullwertcodierung Aufgezählter Typ Wählen Sie in der Dropdownliste eine der folgenden Optionen aus:
  • NULLPadFill. Diese Eigenschaft ist nur bei dem physischen Typ Extern dezimal gültig. Das Feld wird mit dem unter Auffüllzeichen festgelegten Zeichen aufgefüllt. Der Parameterwert der Nullwertcodierung muss eine leere Zeichenfolge sein.
  • NULLLogicalValue. Der Parameterwert der Nullwertcodierung wird dem erforderlichen Feldformat angepasst. Dies ist der Standardwert.
  • NULLLiteralValue. Der Parameterwert der Nullwertcodierung wird wie eine Zeichenfolge direkt ersetzt. Unter Parameterwert der Nullwertcodierung können Sie einen nichtnumerischen Wert eingeben.
  • 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 der Nullwertcodierung Zeichenfolge Die Verwendung dieser Eigenschaft hängt von der oben beschriebenen Eigenschaft Nullwertcodierung ab ( mit Ausnahme der Einstellung NULLLiteralFill). Der Standardwert ist 0 (null).
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 Dropdownliste 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 hexadezimalen Zeichencode ein, beispielsweise 0xYY; dabei steht YY für einen Hexadezimalwert.
  • 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 Beschreibung
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 Integer 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 Integer 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.

Wiederholen

Eigenschaft Typ Beschreibung
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 Dropdown-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.

Zugehörige Konzepte
Nachrichten modellieren
Das Nachrichtenmodell
Custom Wire Format (CWF): Beziehung zum logischen Modell
Zugehörige Tasks
Nachrichtenmodelle entwickeln
Mit Nachrichtenmodellobjekten arbeiten
Zugehörige Verweise
Nachrichtenmodellverweisinformationen
Eigenschaften von Nachrichtenmodellobjekten
Veraltete Objekteigenschaften eines Nachrichtenmodells
Eigenschaften von Verbundelementen
CWF-Eigenschaften von Verbundelementen
Bemerkungen | Marken | Downloads | Bibliothek | Unterstützung | Rückmeldung
Copyright IBM Corporation 1999, 2006 Letzte Aktualisierung: 23. Aug. 2006
ad16290_