Change national language versions

You can change in which national language information is presented on the system.

The i5/OS™ licensed program supports different national languages on the same system. This allows information in one national language to be presented to one user while information in a different national language is presented to another user.

The language used for user-readable information (displays, messages, printed output, and online help information) is controlled by the library list for the job. By adding a national language library to the system portion of the library list, different national language versions of information can be presented. For the primary language, a national language version is the running code and textual data for each licensed program entered. For the secondary language, it is the textual data for all licensed programs.

The language information for the primary language of the system is stored in the same libraries as the programs for IBM^® licensed programs. For example, if the primary national language of the system is English, then libraries such as QSYS, QHLPSYS, and QSSP contain information in English. Libraries QSYS and QHLPSYS are on the system portion of the library list. Libraries for other licensed programs (such as QRPGLE for ILE RPG for i5/OS*) are added to the library list by the system when they are needed.

National language versions other than the system primary language are installed in secondary national language libraries. Each secondary language library contains a single national language version of the displays, messages, commands prompts, and help for all IBM licensed programs. The name of a secondary language library is in the form QSYSnnnn, where nnnn is a language feature code. For example, the feature code for French is 2928, so the secondary national language library name for French is QSYS2928.

If a user wants information presented in the primary national language of the system, no special action is required. To present information in a national language different from the primary national language of the system, the user must change the library list so that the desired national language library is positioned before all other libraries in the library list that contains national language information. You can use any of the following options to position the desired national language library first:

You can use the SYSLIBLE parameter on the CRTSBSD or CHGSBSD to present displays, messages, and so on for a specific language. For example:
```
CRTSBSD SBSD(QSBSD 2928) POOLS((1 *NOTSG)) SYSLIBLE(QSYS2928)
```
You can use the LIB parameter on the CHGSYSLIBL command to specify the desired national language library at the top of the library list. For example:
```
CHGSYSLIBL  LIB(QSYS2928)
```
You can set up an initial program in the user profile to specify the desired national library at the top of the library list for an interactive job. This is a good option if the user does not want to run the CHGSYSLIBL command at every sign-on. The initial program uses the Change System Library List (CHGSYSLIBL) command to add the desired national language library to the top of the library list.
Note: The authority shipped with the CHGSYSLIBL command does not allow all users to run the command.

To enable a user to run the CHGSYSLIBL command without granting the user rights to the command, you can write a CL program containing the CHGSYSLIBL command. The program is owned by the security officer, and adopts the security officer's authority when created. Any user with authority to run the program can use it to change the system part of the library list in the user's job. The following is an example of a program to set the library list for a French user.

PGM
  CHGSYSLIBL  LIB(QSYS2928)  /* Use French information */
ENDPGM