SET NATIONAL LANGUAGE command

Switches your application to a different run-time national language that determines what translation is used when a message is displayed. The switch is effective for the entire run-time environment; it is not restricted to z/OS® Debugger activity only. The initial setting is supplied by Language Environment® or the NATLANG z/OS Debugger run-time option, according to the setting in the current enclave.

Read syntax diagramSkip visual syntax diagramSETNATIONALLANGUAGElanguage_code;
language_code
A valid three-letter set that identifies the language used or (for compatibility) one of the two-letter language codes that was accepted in the previous release of INSPECT for C/370 and PL/I. The language code can have one of the following values:
  • United States English: ENU
  • United States English (Uppercase): UEN
  • Japanese: JPN
  • Korean: KOR
  • If you enter the SET DBCS ON command and then you set the national language to ENU, z/OS Debugger resets the national language to UEN to remain compatible with DBCS characters.
For compatibility with the previous release of INSPECT for C/370 and PL/I:
  • EN or ENGLISH is mapped to ENU
  • UE or UENGLISH is mapped to UEN
  • JA, JAPANESE, NI, or NIHONGO is mapped to JPN

Usage notes

  • In order to display DBCS characters correctly in full-screen mode, the 3270 terminal emulator must be capable of displaying DBCS characters, and the VTAM LOGMODE MODEENT macroinstruction used for the terminal session must contain the following specification(s):
    1. For CICS, full-screen mode using the Terminal Interface Manager and TSO, the LOGMODE MODEENT macroinstruction must contain a PSERVIC parameter value that indicates that the terminal has extended data stream capability and that the terminal is to be queried for alternate screen size.
    2. For TSO, in addition, the LOGMODE MODEENT macroinstruction must contain a LANG parameter value where BIT 0 is 1 (ON). TSO/VTAM uses this bit to indicate that devices with extended data stream capability are queried for language information (DBCS capability).

      You can query this bit in ISPF in the following way:

      • In ISPF, select option 0 (Settings). Press Enter.
      • On the command line, enter: environ. Press Enter.
      • Tab to the section Terminal Status (TERMSTAT). In the Enable field, enter 2 (Query terminal information). Press Enter.
      • Several pages of statistics appear. In the section GTTERM Information, note the value of the highest bit in the second byte of the ATTRIBUTE BYTE (the Language Field). The value of this bit must be 1 (ON). For example, if the value of the ATTRIBUTE BYTE is x008000C9, then DBCS characters display correctly because the second byte is x80. However, if the value of the ATTRIBUTE BYTE is x000000C9, DBCS characters are not displayed properly.
  • The language you select by using the SET NATIONAL LANGUAGE command affects both your application and z/OS Debugger.
  • At the beginning of an enclave, the settings are those provided by Language Environment, your operating system, or the NATLANG z/OS Debugger run-time option. For nested enclaves, the parent's settings are restored upon return from a child enclave.
  • If NATIONAL LANGUAGE is set to JPN or KOR and you are using full-screen mode, enter the SET DBCS ON command so that z/OS Debugger displays messages correctly.

Examples

  • Set the current national language to Japanese. 
    SET NATIONAL LANGUAGE JPN;
SET DBCS ON;
  • Set the current national language to United States English. 
    SET LANGUAGE ENU;

Refer to the following topics for more information related to the material discussed in this topic.