C-Headerdatei: Physische Eigenschaften auswählen

Assistent für neue Nachrichtendefinitionsdateien, C-Headerdatei (Option), Zielnachrichtengruppe auswählen (Referenzmaterial).

C-Headerdatei

Wenn Sie im Assistenten für neue Nachrichtendefinitionsdateien die Option C-Headerdatei verwenden, um eine Nachrichtendefinition zu erstellen, werden folgende Fenster angezeigt:

Fenstereigenschaften

Quellenplattform
Mit dieser Eigenschaft werden die Standardwerte für Codepage, Gleitkommaformat und Byteanordnung festgelegt.
  • (Keine Angabe)
  • Msvc
  • icc
  • AIXgcc
  • AIXxlc
  • OS390
Codepage
Dies zeigt den Standardwert für das, was mit der Eigenschaft 'Quellenplattform' festgelegt wurde. Er sollte nicht verändert werden.
  • ISO8859-1
  • Cp037
  • Cp1252
Gleitkommaformat
Dies zeigt den Standardwert für das, was mit der Eigenschaft 'Quellenplattform' festgelegt wurde. Er sollte nicht verändert werden.
  • IEEE Extended INTEL
  • IEEE Extended AIX
  • IEEE Extended OS/390
  • IEEE Non-Extended
  • IBM 390 Hexadecimal

Speicherbelegung

Adressgröße
Angeben der nativen Adresse der Hardware, für die der C-Header konzipiert wurde. Dies wirkt sich auf Folgendes aus:
  • die CWF-Länge eines importierten Verweises (4|8 Bytes)
  • die CWF-Länge eines 'Langzeichens' (4|8 Bytes)

Wählen Sie die Größe aus, die dem Programm entspricht, das CWF-Nachrichten erstellt oder empfängt.

  • 32 Bit - der Standardwert
  • 64 Bit
Größe von LONG DOUBLE
Dies zeigt den Standardwert für das, was mit der Eigenschaft 'Quellenplattform' festgelegt wurde. Er sollte nicht verändert werden.
  • 64 Bit - der Standardwert
  • 128 Bit
Byteanordnung
  • Little Endian - der Standardwert
  • Big Endian
Packungsstufe
Diese wirkt sich auf die CWF-Byteanordnung zu überspringender führender und abschließender Bytes zugewiesener Elemente aus. Ein C-Importprogramm würde normalerweise eine Variable an einer Grenze ausrichten, die der eigenen Größe entspricht (eine 4-Byte-Ganzzahl wird an einer 4-Byte-Grenze ausgerichtet). Der Compiler würde Leerzeichenpuffer zwischen Variablen in einer Struktur einfügen, um dies zu ermöglichen. Die Packeinstellung stellt einen maximalen Ausrichtungswert für eine Variable bereit. Wenn Ihre Nachrichten Leerzeichenpuffer enthalten, wählen Sie die Packungsstufe aus, die der des Programms entspricht, das CWF-Nachrichten erstellt bzw. empfängt. Wählen Sie '1' aus, wenn kein Leerzeichenpuffer erwünscht ist. Beispiel:
/* Testdatenausrichtung
 * Strukt. mit einem Int. (wird normalerweise an Wortgrenze ausgerichtet)
 *
 *   +---------------------------------------------------
 *   | a,b,c = ein Byte des Elements
 *   |     _ = ein Auffüllbyte
 *   |---------------------------------------------------
 *   |                        111 |
 *   |  Pack     | 1234 5678 9012 | Gesamtstrukturgröße
 *   | ----------+----------------+----------------------
 *   |  1-Byte   | abbb bc        | 6 Bytes
 *   |  2-Byte   | a_bb bbc_      | 8 Bytes
 *   |  4-Byte   | a___ bbbb c___ | 12 Bytes
 *   |  8-Byte   | a___ bbbb c___ | 12 Bytes
 *   +---------------------------------------------------
 *****************************************************/
struct _align01 {
    char align_01_a;
    int  align_01_b;
    char align_01_c;
};
  • 1
  • 2
  • 3
  • 8 - der Standardwert
  • 16
Enum-Größe
Größe (in Bytes) eines Enum. Dies bezieht sich direkt auf den CWF-Längenzähler. Bei der Einstellung 'Kompakt' wird die kleinste Größe bestimmt, die den größten Wert in der Aufzählung enthält. Wählen Sie die Größe aus, die dem Programm entspricht, das CWF-Nachrichten erstellt oder empfängt.
  • 1
  • 2
  • 4
  • Kompakt - der Standardwert
Zeichenfolgecodierung
  • Nullabschluss. Wenn dies ausgewählt ist, wird ein C-Zeichenbereich der Größe n als ein Element des Typs 'xsd:string' mit einer maxLength-Facette von n-1 importiert. Wenn ein physisches CWF-Format für die Nachrichtengruppe definiert wird, ist der physische CWF-Typ des Elements eine Zeichenfolge mit Null am Ende.
  • Feste Länge. Wenn dies ausgewählt ist (Standardeinstellung), wird ein C-Char-Array der Größe n als ein Element des Typs 'xsd:string' mit einer maxLength-Facette von n-1 importiert. Wenn ein physisches CWF-Format für die Nachrichtengruppe definiert wird, ist der physische CWF-Typ des Elements eine Zeichenfolge mit fester Länge mit einem Längenzähler n.

Diese Option gilt nur bei Zeichenbereichen, die momentan als 'xsd:string' importiert werden. Es sind beispielsweise nicht "unsigned char[2]" oder "signed char[2]" enthalten, die beide als Einschränkungen von 'xsd:integer' importiert werden.

Auffüllzeichen für Zeichenfolge
Geben Sie das Auffüllzeichen ein, das verwendet werden soll, wenn die C-Headerdatei importiert wird. Wählen Sie entweder eines aus den vordefinierten aufgelisteten Einträgen aus, oder geben Sie eines an, indem Sie es in das Feld eingeben. Der Wert muss sich in ein einzelnes Zeichen auflösen. Dieses Zeichen kann wie folgt gesetzt werden:
  • Wählen Sie in der Dropdown-Liste NUL (Standardwert), SPACE oder ‘0’ 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 hexadezimalen Zeichencode ein, beispielsweise 0xYY; dabei steht YY für einen Hexadezimalwert.
  • Geben Sie einen dezimalen Zeichencode ein, beispielsweise in der Form YY. Dabei steht YY für einen Dezimalwert.
  • Geben Sie einen Unicode-Wert im Format 'U+xxxx' ein; dabei steht xxxxxx für einen Unicode-Wert im Hexadezimalformat.

Diese Option wird ausgeblendet, wenn die Option 'Zeichenfolgecodierung' keine feste Länge aufweist.

Zugehörige Tasks
Aus C importieren
Zugehörige Verweise
Assistent für neue Nachrichtendefinitionsdateien
Assistent für neue Nachrichtendefinitionsdateien: C-Headerdatei
Bemerkungen | Marken | Downloads | Bibliothek | Unterstützung | Rückmeldung
Copyright IBM Corporation 1999, 2006 Letzte Aktualisierung: 23. Aug. 2006
ad30705_