Derivation: NATional LANGuage

NATLANG specifies the initial national language to be used for the run-time environment, including error messages, month names, and day of the week names. Message translations are provided for Japanese and for uppercase and mixed-case US English. NATLANG also determines how the message facility formats messages.

NATLANG affects only the Language Environment NLS and date and time services, not the Language Environment locale callable services.

You can set the national language by using the NATLANG run-time option or the SET function of the CEE3LNG callable service Language Environment maintains one current language at the enclave level. The current language remains in effect until it is changed. For example, if you specify JPN in the NATLANG run-time option, but later specify ENU using the CEE3LNG callable service, ENU becomes the current national language.

Non-CICS default

NATLANG=((ENU),OVR)

CICS® default

NATLANG=((ENU),OVR)

Amode 64 default

NATLANG=((ENU),OVR)

Syntax

                     .-ENU-.        .-OVR----.      
>>-NATLANG--=--(--(--+-UEN-+--)--,--+-NONOVR-+--)--------------><
                     '-JPN-'                        

ENU

A 3-character ID specifying mixed-case US English.

Message text consists of SBCS characters and includes both uppercase and lowercase letters.

UEN

A 3-character ID specifying uppercase US English.

Message text consists of SBCS characters and includes only uppercase letters.

JPN

A 3-character ID specifying Japanese.

Message text can contain a mixture of SBCS and DBCS characters.

OVR

Specifies that the option can be overridden.

NONOVR

Specifies that the option cannot be overridden.

Usage notes

• Restriction: CEE3LNG and CEESETL are not available to AMODE 64 applications.
• If you specify a national language that is not available on your system, Language Environment® uses the IBM-supplied default ENU (mixed-case US English) and issues a return code of 4 and a warning message. CEEROPT, CEEUOPT, CELQROPT, and CELQUOPT can specify an unknown national language code, but give a return code of 4 and a warning message.
• Language Environment is sensitive to the national language when it writes storage reports, option reports, and dump output. When the national language is uppercase US English or Japanese, the environment variable _CEE_UPPERCASE_DATA can be used to determine whether variable data in storage reports, options reports and dump output is in uppercase. When this environment variable is set to YES, variable data (entry point names, program unit names, variable names, Trace Entry in EBCDIC data, and hexadecimal/EBCDIC displays of storage) are changed to uppercase. When this environment variable is not set or set to a value other than YES, variable data will not be changed to uppercase.. Variable data is never changed to uppercase.when the national language is mixed case US English.

C/C++ considerations

Language Environment provides locales used in C and C++ to establish default formats for the locale-sensitive functions and locale callable services, such as date and time formatting, sorting, and currency symbols. To change the locale, you can use the setlocale() library function or the CEESETL callable service.

The settings of CEESETL or setlocale() do not affect the setting of the NATLANG runtime option. NATLANG affects only Language Environment NLS and date and time services. setlocale() and CEESETL affect only C/C++ locale-sensitive functions and Language Environment locale callable services.

To ensure that all settings are correct for your country, use NATLANG and either CEESETL or setlocale().

PL/I MTF considerations

NATLANG affects every task in the application. The SET function of CEE3LNG is supported for the relinked OS PL/I or PL/I for MVS & VM MTF applications only.

For more information

• For more information about the CEE3LNG callable service, see z/OS Language Environment Programming Reference.
• For more information about setlocale(), see z/OS XL C/C++ Programming Guide.