Open System Services Shell and Utilities Reference Manual (G06.25+, H06.03+)

User Commands (g - j) genxlt(1)
NAME
genxlt - Generates code-set translation table
SYNOPSIS
genxlt [-f outputfile]
[inputfile]
FLAGS
-f outputfile
Specifies that the generated version of the code-set conversion table be placed in the
file specified by outputfile.
Operands
inputfile Specifies the code-set conversion table source file.
DESCRIPTION
The genxlt command reads a source code-set conversion table file from inputfile and writes the
compiled version to outputfile.
If inputfile is not specified, standard input is used. If outputfile is not specified, standard output is
used. The source code-set conversion table provided to genxlt as input contains directives that
are acted upon by the utility to produce the compiled version.
The format of a code-set conversion table source file is:
• An optional target_sub directive in the form: target_sub target [comment]
• An optional source_sub directive in the form: source_sub source [comment]
• Conversion entry lines must be in the form: source target [comment]
The source field must be hexadecimal numbers. The target field must be hexadecimal numbers
or the keyword is invalid. The comment field is optional. Lines whose initial non-space, non-tab
character is the # (number sign) are treated as comment lines. Null lines and lines consisting
only of white-space characters are also treated as comment lines.
The source, target, and comment fields can be separated by any combination of spaces and tabs.
Comments can contain these characters because anything after the second separator is con-
sidered a comment. The maximum value of source is 65535 decimal. The maximum value of
target is 4294967295 decimal. The hexadecimal representations of the values can be specified
by anything acceptable to the scanf() %x conversion specification, from 1 to 8 hexadecimal
digits. If asource value is found in the conversion table multiple times, the last entry is used in
the compilation of the conversion table. If a source value is greater than 0xff (255 decimal),
genxlt creates a conversion table for a double-byte input code set.
Include only valid and invalid conversions in the table. All values of source that are not present
in the first column of the table are considered to be valid for input but have no corresponding tar-
get value. Specific values of source that are invalid for input must be declared invalid by includ-
ing them in the source column with the string invalid in the target column on the same line.
Valid input characters that have no corresponding target value are converted to the target value
specified by the target_sub directive. 0x1A, the ASCII SUB character, is the default if no
target_sub is specified. Conversions of valid input characters to the target_sub character by the
iconv() function are called non-identical conversions.
If the target_sub character has a corresponding character in the input code set, the source value
for that character can be specified by the source_sub directive. 0x1A, the ASCII SUB character,
is the default if no source_sub is specified. Specifying the source_sub character prevents
conversions of source_sub characters to the target_sub character from being counted by iconv()
527188-003 Hewlett-Packard Company 4−7