Defining the language environment - setting the locale

When generating a UTM application, a separate language environment can be defined for the UTM application, for each LTERM partner, for all LTERM partners in an LTERM pool, and for each user ID. To do this, you assign the application and the individual objects a triplet comprising the language identifier, territorial identifier, and name of a character set, which is known as the locale. The locale is specified as follows:

LOCALE=( lang_id,terr_id,ccsname )

lang_id	The language identifier lang_id identifies the language in which the user is to be addressed by the UTM program units. The language identifier can be up to 2 bytes long. The descriptor of a language can be freely selected.
terr_id	The territorial identifier terr_id enables you to take account of regional differences within a language (e.g. English in UK or America) or different units of currency and measurement in the various countries (dollar and sterling). The territorial identifier can be up to 2 bytes long and can be freely selected.
ccsname	The character set name ccsname specifies which character set can be used to edit a message for outputting to the terminal. As the character set name, specify the CCS name of a character set defined in the BS2000 system. CCS names are assigned by the BS2000 system administrator.

If all users come from the same language area, e.g. Western Europe, it is sufficient to assign an extended character set to the UTM application. It is only necessary to use user specific character sets if the various users of an application speak languages that cannot all be represented by an extended character set.

In order to support extended character sets, the subsystem XHCS must be available on the processor on which the UTM application is running. For all character set names generated in the UTM application, associated EBCDIC character sets must be defined in XHCS. In addition, the terminals must support an ISO character compatible with the respective EBCDIC character set. Only particular types of terminals and printers support 8-bit character sets.

Application-specific language environment – standard-language environment

MAX statement in section "MAX - define UTM application parameters" You assign the locale to theUTM application in the generation using the MAX statement:

• LOCALE=

  The locale generated for the application is assigned to each user ID, each LTERM partner, and each LTERM pool as the default value for the language environment. This default setting applies as long as no specific locale is defined for these objects.

User-specific language environment

USER statement in section "USER - define a user ID" You assign a locale to a user ID using the USER statement:

• LOCALE=

  The character set assigned to a user ID is used to output dialog messages to the screen (see the character sets section of the openUTM manual „Programming Applications with KDCS”).

LTERM partner-specific language environment

LTERM statement in section "LTERM - define an LTERM partner for a client or printer" and TPOOL statement in section "TPOOL - define an LTERM pool" You use the LTERM statement to assign a locale to an LTERM partner via which a terminal or printer connects to the application. For an LTERM pool, a locale is defined for all LTERM partners in this pool using the TPOOL statement:

• LOCALE=

  The character set defined for the LTERM partner is used to output asynchronous messages (see also "UTM messages").

  The LTERM partner-specific locale is also used in the first part of the sign-on service, for example, if the user has not yet signed on, i.e. the user-specific language environment is not yet created.

Example

The language identifier DE for German is used in the application. To be able to take account of the different units of currency in messages to users in Germany and Switzerland (Euro and franc), the territorial identifiers De for Germany and CH for Switzerland are defined. The EBCDIC character set EBCDIC.DF.04-1 can be used to output messages. Its CCS name is EDF041.

• The locale for users in Germany can be defined as the standard language environment for the application. To this end, specify the following in the MAX statement:

  MAX ..., LOCALE=(DE,DE,EDF041)

  In this case, no separate locale need be defined for users and terminals in Germany that connect to the application via LTERM partners.

• If language-specific requirements are to be taken into account for users and terminals in Switzerland, the following must be generated:

  USER username ,..., LOCALE=(DE,CH,EDF041)
LTERM ltermname ,..., LOCALE=(DE,CH,EDF041)

• However, you can also use the DEFAULT statement to set the locale (DE,DE,EDF041) for all USER and LTERM statements:

  DEFAULT USER LOCALE=(DE,DE,EDF041)
DEFAULT LTERM LOCALE=(DE,DE,EDF041)

  You must then also generate the following for users and terminals in Switzerland that connect to the application via LTERM partners:

  USER username ,..., LOCALE=(,CH)
LTERM ltermname ,..., LOCALE=(,CH)