National language support (NLS) considerations

When qsh starts, it initializes internal tables for processing commands based on the CCSID of the job. When reading files, qsh and many utilities dynamically translate files from the CCSID of the file to the CCSID of the job. For everything to run correctly, you must configure your environment as documented in the tables below.

A locale contains information about a language and country or region, including how to sort and classify characters and the formats for dates, times, numbers, and monetary values. A locale is set by setting the LANG environment variable to the path name to a locale object. For example, to set the locale for US English, the LANG environment variable is set as follows:

LANG=/QSYS.LIB/EN_US.LOCALE

Start of change It is best to set the LANG environment variable before starting qsh. Some utilities will not work correctly if the locale is not valid for the CCSID and language ID of the job as shown in the tables below. End of change

There can be problems in the following situations:

Supported CCSIDs

The following table shows the supported CCSIDs. It is indexed by CCSID number. If a CCSID is not in the table, qsh sends message 001-0072 and runs as if it was started in CCSID 37.

Supported CCSIDs
CCSID Code Page Description
00037 00037 USA, Canada
00256 00256 International #1
00273 00273 Germany, Austria
00277 00277 Denmark, Norway
00278 00278 Finland, Sweden
00280 00280 Italy
00284 00284 Spain, Latin America
00285 00285 United Kingdom
00297 00297 France
00424 00424 Israel (Hebrew)
00425 00425 Arabic
00500 00500 Belgium, Canada, Switzerland
00833 00833 Korea Extended Single-byte
00836 00836 Simplified Chinese Extended Single-byte
00838 00838 Thailand Extended
00870 00870 Latin-2 Multilingual
00871 00871 Iceland
00875 00875 Greece
00880 00880 Cyrillic Multilingual
00905 00905 Turkey Extended
00918 00918 Pakistan
00933 00833, 00834 Korea Extended Mixed
00935 00836, 00837 Simplified Chinese Extended Mixed
00937 00037, 00835 Traditional Chinese Extended Mixed
00939 01027, 00300 Japan English Extended Mixed
01025 01025 Cyrillic Multilingual
01026 01026 Turkey
01027 01027 Japan Latin Extended Single-byte
01097 01097 Farsi
01112 01112 Baltic Multilingual
01122 01122 Estonian
01123 01123 Cyrllic Ukraine
01130 01130 Vietnam
01132 01132 Lao
01137 01137 Devanagari
01140 01140 USA, Canada euro
01141 01141 Germany, Austria euro
01142 01142 Denmark, Norway euro
01143 01143 Finland, Sweden euro
01144 01144 Italy euro
01145 01145 Spain, Latin America euro
01146 01146 United Kingdom euro
01147 01147 France euro
01148 01148 Belgium, Canada, Switzerland euro
01149 01149 Iceland euro
01153 01153 Latin-2 Multilingual euro
01154 01154 Cyrllic Multilingual euro
01155 01155 Turkey euro
01156 01156 Baltic Multilingual euro
01157 01157 Estonia euro
01158 01158 Cyrillic Ukraine euro
01160 01160 Thailand Extended euro
01164 01164 Vietnam euro
01388 00836, 00837 Simplified Chinese Host Data Mixed
01399 01399, 00300 Japan English Extended Mixed euro
05035 01027, 00300 Japan English Extended Mixed
05123 01399 Japan English Extended Single-byte euro
09030 00838 Thailand Extended Single-byte
13124 00836 Simplified Chinese Host Data Single-byte
28709 00037 Traditional Chinese Extended

Supported Languages

The following table shows the supported languages. It is indexed by language. In the Language field, the value in parentheses is the value to use for the LANGID parameter of the CHGJOB CL command. In the Country or Region field, the value in parentheses is the value to use for the CNTRYID parameter of the CHGJOB CL command.

Note that there are more valid combinations of Language, Country or Region, CCSID, and Locale than are listed in the table. For example, there is only one entry for the Spanish language even though it is used in more than one country or region.

When running Qshell, the LANGID, CNTRYID, CCSID job attributes must be set to the values listed in the table, and the LANG environment variable must be set to the listed locale.

Supported Languages
Language Country or Region Id CCSID Locale
Albanian (SQI) Albania (AL) 00500 /QSYS.LIB/SQ_AL.LOCALE
Arabic (ARA) Arabic Area (AA) 00425 /QSYS.LIB/AR_AA.LOCALE
Belgian Dutch (NLB) Belgium (BE) 00500 /QSYS.LIB/NL_BE.LOCALE
Belgian Dutch Euro (NLB) Belgium (BE) 01148 /QSYS.LIB/NL_BE_E.LOCALE
Belgian French (FRB) Belgium (BE) 00500 /QSYS.LIB/FR_BE.LOCALE
Belgian French Euro (FRB) Belgium (BE) 01148 /QSYS.LIB/FR_BE_E.LOCALE
Belgium English (ENB) Belgium (BE) 00500 /QSYS.LIB/EN_BE.LOCALE
Brazilian Portugese (PTB) Brazil (BR) 00037 /QSYS.LIB/PT_BR.LOCALE
Bulgarian (BGR) Bulgaria (BG) 00037 /QSYS.LIB/BG_BG.LOCALE
Canadian French (FRC) Canada (CA) 00500 /QSYS.LIB/FR_CA.LOCALE
Croatian (HRV) Croatia (HR) 00870 /QSYS.LIB/HR_HR.LOCALE
Czech (CSY) Czech Republic (CZ) 00870 /QSYS.LIB/CS_CZ.LOCALE
Danish (DAN) Denmark (DK) 00277 /QSYS.LIB/DA_DK.LOCALE
Dutch (NLD) Netherlands (NL) 00037 /QSYS.LIB/NL_NL.LOCALE
Dutch Euro (NLD) Netherlands (NL) 01140 /QSYS.LIB/NL_NL_E.LOCALE
English Upper Case (ENP) United States (US) 00037 /QSYS.LIB/EN_UPPER.LOCALE
Estonian (EST) Estonia (EE) 01122 /QSYS.LIB/ET_EE.LOCALE
Finnish (FIN) Finland (FI) 00278 /QSYS.LIB/FI_FI.LOCALE
Finnish Euro (FIN) Finland (FI) 01143 /QSYS.LIB/FI_FI_E.LOCALE
French (FRA) France (FR) 00297 /QSYS.LIB/FR_FR.LOCALE
French Euro (FRA) France (FR) 01147 /QSYS.LIB/FR_FR_E.LOCALE
German (DEU) Germany (DE) 00273 /QSYS.LIB/DE_DE.LOCALE
German Euro (DEU) Germany (DE) 01141 /QSYS.LIB/DE_DE_E.LOCALE
Greek (ELL) Greece (GR) 00875 /QSYS.LIB/EL_GR.LOCALE
Hebrew (HEB) Israel (IL) 00424 /QSYS.LIB/IW_IL.LOCALE
Hungarian (HUN) Hungary (HU) 00870 /QSYS.LIB/HU_HU.LOCALE
Icelandic (ISL) Iceland (IS) 00871 /QSYS.LIB/IS_IS.LOCALE
Italian (ITA) Italy (IT) 00280 /QSYS.LIB/IT_IT.LOCALE
Italian Euro (ITA) Italy (IT) 01144 /QSYS.LIB/IT_IT_E.LOCALE
Japanese Katakana (JPN) Japan (JP) 05035 /QSYS.LIB/JA_5035.LOCALE
Japanese Full (JPN) Japan (JP) 13488 /QSYS.LIB/JA_13488.LOCALE
Korean (KOR) South Korea (KR) 00933 /QSYS.LIB/KO_KR.LOCALE
Latvian (LVA) Latvia (LV) 01112 /QSYS.LIB/LV_LV.LOCALE
Lithuanian (LTU) Lithuania (LT) 01112 /QSYS.LIB/LT_LT.LOCALE
Macedonian (MKD) Macedonia (MK) 01025 /QSYS.LIB/MK_MK.LOCALE
Norwegian (NOR) Norway (NO) 00277 /QSYS.LIB/NO_NO.LOCALE
Polish (PLK) Poland (PL) 00870 /QSYS.LIB/PL_PL.LOCALE
Portugese (PTG) Portugal (PT) 00037 /QSYS.LIB/PT_PT.LOCALE
Portugese Euro (PTG) Portugal (PT) 01140 /QSYS.LIB/PT_PT_E.LOCALE
Romanian (ROM) Romania (RO) 00870 /QSYS.LIB/RO_RO.LOCALE
Russian (RUS) Russia (RU) 01025 /QSYS.LIB/RU_RU.LOCALE
Serbian Cyrillic (SRB) Serbia (SQ) 01025 /QSYS.LIB/SR_SP.LOCALE
Serbian Latin (SRL) Serbia (SQ) 00870 /QSYS.LIB/SH_SP.LOCALE
Simplified Chinese (CHS) China (CN) 00935 /QSYS.LIB/ZH_CN.LOCALE
Slovakian (SKY) Slovakia (SK) 00870 /QSYS.LIB/SK_SK.LOCALE
Slovenian (SLO) Slovenia (SI) 00870 /QSYS.LIB/SL_SI.LOCALE
Spanish (ESP) Spain (ES) 00284 /QSYS.LIB/ES_ES.LOCALE
Spanish Euro (ESP) Spain (ES) 01145 /QSYS.LIB/ES_ES_E.LOCALE
Swedish (SVE) Sweden (SE) 00278 /QSYS.LIB/SV_SE.LOCALE
Swiss French (FRS) Switzerland (CH) 00500 /QSYS.LIB/FR_CH.LOCALE
Swiss German (DES) Switzerland (CH) 00500 /QSYS.LIB/DE_CH.LOCALE
Thai (THA) Thailand (TH) 00838 /QSYS.LIB/TH_TH.LOCALE
Turkish (TRK) Turkey (TR) 00905 /QSYS.LIB/TR_TR.LOCALE
Ukrainian (UKR) Ukraine (UA) 01025 /QSYS.LIB/UK_UA.LOCALE
UK English (ENG) United Kingdom (GB) 00285 /QSYS.LIB/EN_GB.LOCALE
US English (ENU) United States (US) 00037 /QSYS.LIB/EN_US.LOCALE

For more details, see the iSeries Globalization IBM Code Pageslink outside Information Center.