GDDM V3R2 Base Application Programming Reference
Previous topic | Next topic | Contents | Index | Contact z/OS | Library | PDF | BOOK


Double-byte character string fields

GDDM V3R2 Base Application Programming Reference
SC33-0868-02



Double-byte character strings (DBCS) fields are specially treated in some cases. (Double-byte character string fields are used for Kanji and Hangeul applications).

A field can be designated as DBCS by using GDDM-IMD's Field Definition steps, or Field Attribute Definition steps, or both of these.

A field can also be changed to or from DBCS by using a PS attribute adjunct and specifying a value of X'F8' (C'8') for DBCS, or C' ' (or any other valid value) for EBCDIC.

However, the special treatment of length adjuncts and cursor positioning provided for DBCS fields depends only on how the fields were defined to GDDM-IMD. Dynamically changing a field to or from DBCS does not change this treatment.

The special treatment is:

Length adjuncts
If a field is designated at map definition time as a DBCS field, the field's length adjunct is always interpreted as several two-byte characters. Hence, the length of the data in bytes is twice the value of the length adjunct.


Cursor position
If a field is designated at map definition time as a DBCS field, the cursor position specified by MSCPOS and returned by MSQPOS is interpreted as several two-byte characters. Hence, the position within the field in bytes is twice the value specified (minus 1).

Go to the previous page Go to the next page



Copyright IBM Corporation 1990, 2012