NATLANG

Derivation: NATional LANGuage

NATLANG specifies the initial national language Language Environment uses for the runtime environment, including error messages, month names, and day of the week names. Message translations are provided for Japanese and for uppercase and mixed-case U.S. English. NATLANG also determines how the message facility formats messages.

The default value for non-CICS applications is NATLANG(ENU).

The default value for CICS® applications is NATLANG(ENU).

The default value for AMODE 64 applications is applications is NATLANG(ENU).

Syntax

               .-ENU-.      
>>-NATlang--(--+-----+--)--------------------------------------><
               +-UEN-+      
               '-JPN-'      

ENU

A 3-character ID specifying mixed-case U.S. English. Message text consists of SBCS characters and includes both uppercase and lowercase letters.

UEN

A 3-character ID specifying uppercase U.S. 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.

Usage notes

• Restriction: CEE3LNG and CEESETL are not available to AMODE 64 applications.
• You can use the CEE3LNG callable service to set the national language.
• If you specify a national language that is not available on your system, Language Environment uses the IBM-supplied default ENU (mixed-case U.S. English).
• Language Environment is sensitive to the national language when it writes storage reports, option reports, and dump output.

  When the national language is uppercase U.S. English or Japanese, the environment variable _CEE_UPPERCASE_DATA can be used to determine if 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, hexadecimal/EBCDIC displays of storage) will be in uppercase.

  When this environment variable is not set or set to a value other than YES, variable data will not be in uppercase. Variable data is never in uppercase when the national language is mixed-case U.S. English.

• Language Environment provides locales used in C/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 the 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 consideration—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 CEE3LNG—Set national language.
• For more information about the CEESETL callable service, see CEESETL—Set locale operating environment.
• For more information about setlocale(), see z/OS XL C/C++ Programming Guide.