$SYS_CHARSET

Specify the character set used for communication with the operating system and for communication between Uniface and non-Uniface components, if they are not Unicode-based.

$SYS_CHARSET {=} CharacterSet

Defaults

Assignment file: Any application assignment file
Section: [SETTINGS]
Default value: None

Arguments

CharacterSet—character set supported by both the operating system and Uniface. The allowed values for CharacterSet are listed in the following table.

Uniface-Supported Character Sets

Character Set

Description Platform
CP1250 Code page 1250 for Eastern European language Windows
CP1251 Code page 1251 for Cyrillic language Windows
CP1252 Code page 1252 for Western European language Windows
CP1253 Code page 1253 for Greek Windows
CP1255 Code page 1255 for Hebrew Windows
CP1256 Code page 1256 for Arabic Windows
CP708 Code page 708 (7-bit) for Arabic Windows
BIG5 Traditional Chinese character set BIG5. Windows, Unix, Linux
GB (or GB2312) Simplified Chinese character set GB2312-80 (code page 936) Windows, Unix, Linux
KSC (or KSC5601) Korean character set KSC5601-1992 (code page 949) Windows, Unix, Linux
Shift-JIS Japanese character set Shift-JIS ( code page 932 and 943) Windows, Unix, Linux
EUC Japanese character set EUC Unix, Linux
LATIN1 (or DEC) ISO 8859-1 for Western European languages Unix, Linux
LATIN2 ISO 8859-2 for Eastern European languages Unix, Linux
LATIN5 ISO 8859-5 for Cyrillic languages Unix, Linux
LATIN6 ISO 8859-6 for Arabic Unix, Linux
LATIN7 ISO 8859-7 for Greek Unix, Linux
LATIN8 ISO 8859-8 for Hebrew Unix, Linux
037 CCSID for English iSeries
500 CCSID for English without € Multilingual iSeries
1148 CCSID for English with € Multilingual iSeries
870 CCSID for Easter European languages iSeries
424 CCSID for Hebrew iSeries
935 CCSID for Simplified Chinese iSeries
933 CCSID for Korean iSeries
9301 CCSID for Japanese iSeries
939 CCSID for Japanese iSeries
273 CCSID for German/Austrian without € iSeries
1141 CCSID for German/Austrian with € iSeries
280 CCSID for Italian without € iSeries
1144 CCSID for Italian with € iSeries
284 CCSID for Spanish without € iSeries
1145 CCSID for Spanish with € iSeries
297 CCSID for French without € iSeries
1147 CCSID for French with €

iSeries

278 CCSID for Finish/Swedish without € iSeries
1143 CCSID for Finish/Swedish with € iSeries
AIX (or IBMRT) IBM RT  

CP437 (or IBMPC)

IBM PC code page 437, used in DOS programs  

CP850

IBM PC code page 850  
UTF8 Unicode  

Description

Uniface uses Unicode to communicate with Unicode-based components, such as Web services call-in and call-out, and uses $SYS_CHARSET to communicate with components that are not Unicode-based, such as C call-in and call-out.

There are many communication channels between Uniface and the operating system. For each of them, if Unicode is used on the operating system, Uniface uses Unicode for the communication; otherwise, $SYS_CHARSET is used for the communication.

For example, to display or input string field characters in Microsoft Windows, Unicode is used because Windows uses Unicode to code characters. If a text file is stored using Unicode format, Unicode is also used. Otherwise, $SYS_CHARSET is used for the file’s I/O activities between Uniface and the operating system.

The Uniface installation program initializes $SYS_CHARSET to the character set selected during Uniface installation (in the Character set selection screen). After installation, it is recommended that you check if $SYS_CHARSET is set correctly. You can use the ProcScript function $sys_charset to test the value of $SYS_CHARSET.

A different character set can be specified for accessing zip files using $ZIP_CHARSET.

$SYS_CHARSET

For example, if Uniface is installed on an English Series:

$SYS_CHARSET = 037

Related Topics