How a language is displayed for IBM i functions

If you want information presented in a language other than the primary language of the system, you must first have a secondary language loaded. When a secondary language is loaded, you have three ways to display information in that language.

Method 1: Placing the language you want at the top of your library list

One way to display information in a secondary language is to change the system part of your library list so the library of the national language you want is positioned before all other libraries in the system library list that contain national language information.

For example, to present the French version of textual data, you can enter the following command to place French information at the top of the library list:

CHGSYSLIBL  LIB(QSYS2928)  OPTION(*ADD)

To remove a library from the library list enter:

CHGSYSLIBL  LIB(QSYS2928)  OPTION(*REMOVE)
Note: The authority included with the CHGSYSLIBL command does not allow all users to run the command. As included, you must have *ALLOBJ and *SECADM special authority to use the Change System Library List (CHGSYSLIBL) command.

Method 2: Creating a subsystem for the language you want

A second way to present information in a different language is to follow these steps:

  1. Create a subsystem for the secondary language.
  2. Define the subsystem system part of the library list entry with the national language version library for the secondary language.

All jobs running in the subsystem use textual data from the secondary language. All jobs that you submit as batch jobs have the national language version library as the first library on the system part of the library list.

Method 3: Changing the library list for your job so that the national language version library for the secondary language is the first library on the system part of the library list

A third way to present information in a different language is to change the library list for your job so that the national language version library for the secondary language is the first library on the system part of the library list. All jobs running in the subsystem use textual data from the secondary language. All jobs that you submit as batch jobs have the national language version library as the first library on the system part of the library list.

How a language of your choice is displayed for licensed programs

Libraries for licensed programs are either added automatically, or must be added by the user, when needed. For example, when a licensed program does not provide a translation for the primary language of the system, you need to choose a secondary language that is supported to interface with that program. After you install the secondary language, the text is found in the appropriate QSYS29xx library. After the secondary language is installed, you can use the one of the three methods that are described to change all system interfaces to the secondary language to use this licensed program. If you want to leave the rest of the interfaces in the default language and enable the secondary language for only this licensed program, you can add the QSYS29xx library to the users part of the library list. These steps enable the licensed program's translation to be found.

An example of French as a secondary language would have the text in library QSYS2928. For more information about the numbers that are used, see National language version feature codes. If you want to add libraries for other licensed programs to your library list, use the CHGLIBL command.