Translating CA Dataquery › Language Codes

Language Codes

Requirements

Before you begin actual translation, you must select a language code. A language code:

• Must be two characters in length
• Cannot be AE, GE, or FR

You must assign this two-character language code to each vocabulary term, panel, or literal you translate or change. CA Dataquery uses this code to identify the language to which the translated item belongs.

CA Dataquery uses AE as the language code to identify its American English version, GE for its German version, and FR for its French version.

If you want CA Dataquery to execute in a language other than the language specified at system installation, you must specify this language code in your User Profile. For an overview, see Using the Language Maintenance Facility. The User Profile contains two fields for identifying the language in which you want to see CA Dataquery execute. These fields are:

• PRIMARY LANGUAGE
• SECONDARY LANGUAGE

When you specify a language code in your User Profile in the Primary or Secondary fields CA Dataquery uses this code to search for items that have been translated using that code.

Search Order

During normal CA Dataquery execution, CA Dataquery displays menus, panels, messages, literals, vocabulary and Help panels in the following order:

1. Primary Language
2. Secondary Language
3. American English

If CA Dataquery does not find the item in the Primary or Secondary language, CA Dataquery displays the item in the base language (American English).

This search order is important when you create partial translations. Listing the language code of a partial translation as your primary language allows CA Dataquery to use translated items where available. If a translated item is not available, CA Dataquery looks for that item in the secondary language. If no secondary item is found, CA Dataquery defaults to American English.

Defaults

If you do not have a Primary Language specified in your profile, CA Dataquery defaults the Primary Language to the value specified in the SYSDIAL= parameter during CA Dataquery system generation.

If you do not have a Secondary Language specified, CA Dataquery defaults to the value specified in the SYSLANG= parameter during CA Dataquery system generation.

Primary

SYSDIAL=

Secondary

SYSLANG=

The SYSDIAL= and SYSLANG= parameters are located in the CA Dataquery System Option Table.

Example

A company translates the entire CA Dataquery system into Spanish for several employees recently transferred from Spain. After the system has been completely translated they want to further customize some error and informational messages. The company assigns the codes as follows:

This company uses the primary language to further customize error messages in the complete Spanish translation. Because this customization is a partial customization (applying only to error messages) the language code is placed in the Primary Language field. This means that CA Dataquery searches for an item with the CO language code assigned first. If the item is not found with the CO language code, CA Dataquery searches for that item in the ES (Spanish) version. If CA Dataquery cannot find that item in ES (Spanish), CA Dataquery defaults to English.

This structure accommodates all users of the system. If users require Spanish, they specify CO as their primary language and ES as their secondary language. American English-speaking employees leave the language fields in their User Profile blank.