An OpenVMS XPG4 localization utility that:

    o  Compiles conversion table files.  A conversion table file
       defines how characters in one codeset are converted to
       characters in another codeset (ICONV COMPILE)

    o  Converts characters from one codeset to another (ICONV
       CONVERT)

   For more information on the XPG4 utilities, including file
   formats, see the VSI C Run-Time Library Reference Manual.
   Also see help for the related commands GENCAT and LOCALE.

   Format:

        ICONV option

1  –  COMPILE

   Creates a conversion table file from a conversion source file.
   The conversion table file is used by ICONV CONVERT to convert
   characters in a file from one codeset to another.

   Format:

        ICONV COMPILE sourcefile tablefile

1.1  –  Parameters

   sourcefile

     The file specification of the conversion source file.  The
     default file type is .ISRC.  The file naming convention OpenVMS
     uses for conversion source files is:

     fromcodeset_tocodeset.isrc

   tablefile

     The file specification of the conversion table file to be
     created.  The default file type is .ICONV.  The file naming
     convention for conversion table files is:

     fromcodeset_tocodeset.iconv

     Public conversion table files are in the directory defined by
     the logical name SYS$I18N_ICONV.  Put new conversion table files
     in the same directory if you want to make them available
     system-wide.

2  –  CONVERT

   Converts characters in a file from one codeset to another codeset.
   The converted characters are written to an output file.

   Format:

        ICONV CONVERT infile outfile

2.1  –  Parameters

   infile

     The file specification of the file that contains the characters
     to be converted.  (Use the /FROMCODE qualifier to specify the
     codeset of the characters in this file.)

   outfile

     The file specification of the file created by ICONV CONVERT.
     (Use the /TOCODE qualifier to specify the codeset of the
     characters in this file.)

2.2  –  Qualifiers

   /FROMCODE=fromcodeset

     A required qualifier that specifies the codeset of the
     characters in the input file (infile).

   /TOCODE=tocodeset

     A required qualifier that specifies the codeset of the
     characters in the output file (outfile).

     Public conversion table files are in the directory defined by
     the logical name SYS$I18N_ICONV.  Put new conversion table files
     in the same directory if you want to make them available
     system-wide.