uconvdef — Create binary conversion tables

Format

uconvdef [–f SrcFile] [–v] uconvTable

Description

uconvdef reads SrcFile and creates uconvTable, a binary conversion table. SrcFile is the input source file that defines a mapping between UCS-2 and multibyte code sets. UCS-2 is the Universal Character Set, coded in 2 octets, as defined by ISO/IEC 10646-1:1993(EE), while multibyte code sets consists of one or more bytes per character.

uconvTable is in a format that can be opened and read by iconv conversion functions.

Options

–f SrcFile: SrcFile is the input source file that defines a mapping between UCS-2 and another single or multibyte code set. If this option is not used, standard input is read. For information about the format of the input source table, refer to the ucmap description in z/OS XL C/C++ Programming Guide.
–v: Specifies that the SrcFile file statements be displayed.
uconvTable: Specifies the path name of the compiled table created by the uconvdef command. This file defines conversions into and out of UCS-2.

Examples

To create the compiled uconvTable that defines the conversion table between IBM-1047 and UCS-2, issue:

uconvdef –f IBM-1047.ucmap /usr/lib/nls/locale/uconvTable/IBM-1047

The \ (backslash) is a line continuation character that is needed if the command is broken into multiple lines.

Exit values

0: Successful completion.
>0: An error occurred.

Related information

iconv

The iconv subroutine, iconv_close subroutine, iconv_open subroutine (refer to z/OS XL C/C++ Programming Guide).