Error Messages

The following error messages may be generated when running your application through the cobutf8 utility:

Could not execute cmdline <cmdline>

cobutf8 could not execute the program specified. Make sure that the syntax is correct and that the specified program exists.

Internal COBUTF8 Error: <error no>

Internal error; contact SupportLine, quoting <error no>.

Locale is not set to UTF-8

The system locale is not set to a UTF-8 locale; a UTF-8 locale is a pre-requisite of the cobutf8 utility.

COBUTF8 not set

The COBUTF8 environment variable is not set; set this variable to a target locale specified in cobutf8.cfg (e.g. COBUTF8=ja_JP.sjis).

Failed to set locale: <locale>. Please set environment variable COBUTF8 to a valid locale

The locale stored in the COBUTF8 environment variable is not supported by the operating system; ensure that COBUTF8 is set to a valid locale.

A list of valid locales can be found in the cobutf8.cfg configuration file - located in $COBDIR/etc/.

To list the supported locales, use the locale -a command. If the one you require is not listed, you can install it using the following command:

localedef -f <locale-name> -i <file-name>

For example:

localedef -f SHIFT_JIS -i ja_JP ja_JP.SJIS

Invalid conversion mapping between <locale1> -> <locale2>

cobutf8 failed to create a conversion mapping between UTF-8 and the target iconv; ensure that a valid iconv entry exists in the cobutf8.cfg configuration file.

Use the iconv -l command for a list of valid iconvs.

Could not map locale <locale> to iconv encoding

The locale specified by the COBUTF8 environment variable does not have a iconv mapping to a valid character set; either set COBUTF8 to a locale specified in the cobutf8.cfg configuration file, or edit the configuration file to adding your own mapping.

Failed to open mapping file: <path>

The cobutf8 utility failed to open the cobutf8.cfg configuration file; ensure that the file is located in $COBDIR/etc/, and that you have read access to the file.