Informix Guide to GLS Functionality Managing GLS Files

To comply with DOS 8.3 naming conventions, Informix products use condensed filenames to store GLS locales and code-set-conversion files. These filenames do not match the names of the locales and code sets that the end user uses. You can use the glfiles utility to generate a list of the following GLS-related files:

• The GLS locales that are available on your system
• The Informix code-set-conversion files that are available on your system
• The Informix code-set files that are available on your system

Before you run glfiles, take the following steps:

• Set the INFORMIXDIR environment variable to the directory in which you install your Informix product.

If you do not set INFORMIXDIR, glfiles checks the /usr/informix directory for the GLS files.

• Change to the directory where you want the files that glfiles generates to reside.

The utility creates the GLS file listings in the current directory.

The following diagram shows the syntax of the glfiles utility.

The glfiles utility can create a file that lists the available GLS locales in the following ways:

• When you specify the -lc command-line option
• When you omit all command-line options

For each lcX subdirectory in the gls directory specified in INFORMIXDIR, glfiles creates a file in the current directory that is called lcX.txt, where X is the version number of the locale object-file format. The lcX.txt file lists the locales in alphabetical order, sorted on the name of the GLS locale object file.

Figure A-1 shows a sample file, lc11.txt, that contains the available GLS locales.

Filename: lc11/ar_ae/0441.lco

Language: Arabic

Territory: United Arabic Emirates

Modifier: greg

Code Set: 8859-6

Locale Name: ar_ae.8859-6



Filename: lc11/ar_ae/0441greg.lco

Language: Arabic

Territory: United Arabic Emirates

Modifier: greg

Code Set: 8859-6

Locale Name: ar_ae.8859-6
. . .




Filename: lc11/en_us/0333.lco

Language: English

Territory: United States

Code Set: 8859-1

Locale Name: en_us.8859-1



Filename: lc11/en_us/0333dict.lco

Language: English

Territory: United States

Modifier: dict

Code Set: 8859-1

Locale Name: en_us.8859-1



Filename: lc11/en_us/0352.lco

Language: English

Territory: United States

Code Set: PC-Latin-1

Locale Name: en_us.PC-Latin-1



Filename: lc11/en_us/04e4.lco

Language: English

Territory: United States

Code Set: CP1252

Locale Name: en_us.CP1252
. . .

Examine the lcX.txt files to determine the GLS locales that the $INFORMIXDIR/gls/lcX directory on your system supports.

To find out which GLS locales are available on your Windows NT system, you must look in the GLS system directories. A GLS locale resides in the following file:

%INFORMIXDIR%\gls\lcX\lg_tr\codemodf.lco

In this path, INFORMIXDIR is the environment variable that specifies the directory in which you install the Informix product, gls is the subdirectory that contains the GLS system files, X represents the version number of the locale file format, lg is the two-character language name, tr is the two-character territory name that the locale supports, and codemodf is the condensed locale name.

When you specify the -cv command-line option, the glfiles utility creates a file that lists the available code-set-conversion files. For each cvY subdirectory in $INFORMIXDIR/gls, glfiles creates a file in your current directory that is called cvY.txt, where Y is the version number of the code-set-conversion object-file format. The cvY.txt file lists the code-set conversions in alphabetical order, sorted on the name of the object code-set-conversion file.

For two-way code-set conversions, the $INFORMIXDIR/gls/cvY directory contains two code-set-conversion files. One file supports conversion from the characters in code set A to their mappings in code set B, and another supports the conversion in the return direction (from code set B to code set A). For more information on two-way code-set conversion, see page A-13.

Figure A-2 shows a sample file, cv9.txt, that contains the available code-set conversions.

Filenames: cv9/002501b5.cvo and cv9/01b50025.cvo

Between Code Set: Greek

        and Code Set: IBM CCSID 437



Filenames: cv9/00250333.cvo and cv9/03330025.cvo

Between Code Set: Greek

        and Code Set: ISO8859-1



Filenames: cv9/033304e4.cvo and cv9/004e40333.cvo

Between Code Set: 8859-1

        and Code Set: 1252

Examine the cvY.txt file to determine the code-set conversions that the $INFORMIXDIR/gls/cvY directory on your system supports.

When you specify the -cm command-line option, the glfiles utility creates a file that lists the available character mapping (charmap) files. For each cmZ subdirectory in $INFORMIXDIR/gls, glfiles creates a file in the current directory that is called cmZ.txt, where Z is the version number of the charmap object-file format. The cmZ.txt file lists the character mappings in alphabetical order, sorted on the name of the GLS object charmap file.

Figure A-3 shows a sample file, cm3.txt, that contains the available character mappings.

Filename: cm3/032d.cm

Code Set: 8859-7



Filename: cm3/0333.cm

Code Set: 8859-1



Filename: cm3/0352.cm

Code Set:  PC-Latin-1



Filename: cm3/04e4.cm

Code Set:  CP1252

Examine the cmZ.txt file to determine the character mappings that the $INFORMIXDIR/ gls/cmZ directory on your system supports.