IBM Support

Using Locales

Troubleshooting


Problem

This document provides some basic usage information on locales.

Resolving The Problem

This document covers some basic usage information on locales, which were introduced with V3R7M0.

locale. A locale is an object that can determine how data is processed, printed, and displayed. Locales are made up of categories that define language, cultural data, and character sets. These combinations of language, cultural data, and character sets comprise a locale. Locales, in the form of a system object, are not shipped with the IBM® System i™ system. Rather, the locale definition source files are provided.

A locale definition source file contains one or more categories that describe (or make up) a locale. Locales are created using the Create Locale (CRTLOCALE) command. The source used to create the locale is derived from system-supplied source definition files. These source definition files cannot be changed or edited. Instead, they must be copied and then edited if changes are desired.

The original locale source members, which are in text form, can be found in QSYSLOCALE/QLOCALESRC. Copies of locale members can be edited using SEU.

In PDM, locale source members show as having a blank type; Option 14 in PDM cannot be used to compile them, and an attempt to do so results in message PDM0306. Rather, use the CRTLOCALE command as described the following URL:

http://publib.boulder.ibm.com/infocenter/iseries/v5r4/topic/nls/rbagsixamplecreatelocale.htm

The following URL provides examples for enabling a locale system wide (change the QLOCALE system value) or for an individual user:

http://publib.boulder.ibm.com/infocenter/iseries/v5r4/topic/nls/rbagsinstalllocales.htm

Only the following items from locales are used directly by the system (see the SETJOBATR parameter of CL command CHGUSRPRF):

*CCSID
*DATFMT
*DATSEP
*DECFMT
*SRTSEQ
*TIMSEP

All other locale items must be retrieved using APIs QLGRTVLC (OPM) or QlgRetrieveLocaleInformation (ILE) and handled directly in a user applications, as required. Documentation about the usage of the API can be found at the following URL:

http://publib.boulder.ibm.com/infocenter/iseries/v5r4/topic/nls/rbagslocaleprogexamp.htm

[{"Product":{"code":"SWG60","label":"IBM i"},"Business Unit":{"code":"BU058","label":"IBM Infrastructure w\/TPS"},"Component":"Job and system Management","Platform":[{"code":"PF012","label":"IBM i"}],"Version":"Version Independent","Edition":"","Line of Business":{"code":"LOB57","label":"Power"}}]

Historical Number

16522145

Document Information

Modified date:
18 December 2019

UID

nas8N1018000