imsimta chbuild

The imsimta chbuild command compiles the character
set conversion tables and loads the resulting image file into shared memory.
The MTA ships with complete character set tables so you would not normally
need to run this command. You would use imsimta chbuild only
if you added or modified any character sets.

Syntax

Options

The options for this command are:

Option

Description

-image_file=file_spec | -noimage_file

By default, imsimta chbuild creates as output the
image file named by the IMTA_CHARSET_DATA option of the
MTA tailor file, msg-svr-base/config/imta_tailor. With the -image_file option, an alternate file
name may be specified. When the -noimage_file option is
specified, imsimta chbuild does not produce an output image
file. The -noimage_file option is used in conjunction with
the -option_file option to produce as output an option
file that specifies table sizes adequate to hold the tables required by the
processed input files.

-maximum | -nomaximum

The file msg-svr-base/config/maximum_charset.dat is read in addition to the file named by the IMTA_CHARSET_OPTION_FILE option of the MTA tailor file, msg-svr-base/config/imta_tailor, when -maximum is specified.
This file specifies near -maximum table sizes but does
not change any other settings. Use this option only if the current table sizes
are inadequate. The -noimage and -option_file options
should always be used in conjunction with this option—it makes no sense
to output the enormous configuration that is produced by -maximum,
but it does make sense to use -maximum to get past size
restrictions in order to build a properly sized option file for use in building
a manageable configuration with a subsequent imsimta chbuild invocation.

-option_file=[option_file] | -nooption_file

imsimta chbuild can produce an option file that contains
the correct table sizes to hold the conversion tables that were just processed
(plus a little room for growth). The -option_file option
causes this file to be output. By default, this file is the file named by
the IMTA_CHARSET_OPTION_FILE option of the MTA tailor file, msg-svr-base/config/imta_tailor. The value
of the -option_file option may be used to specify an alternate
file name. If the -nooption_file option is given, then
no option file is output. imsimta chbuild always reads
any option file (for example, the file named by the IMTA_OPTION_FILE option
of the MTA tailor file) that is already present; use of this option does not
alter this behavior. However, use of the -maximum option
causes imsimta chbuild to read options from maximum_charset.dat in addition to IMTA_CHARSET_OPTION_FILE. This
file specifies near-maximum table sizes. Use this option only if the current
table sizes are inadequate, and only use it to create a new option file. The -noimage_file option should always be specified with -maximum,
since a maximum-size image would be enormous and inefficient.

-remove

Removes any existing compiled character set conversion table. This is
the file named by the IMTA_CHARSET_DATA option of the MTA
tailor file, msg-svr-base/config/imta_tailor.

-sizes | -nosizes

The -sizes option instructs imsimta chbuild to
output or suppress information on the sizes of the uncompiled conversion tables.
The -nosizes option is the default.

-statistics | -nostatistics

The -statistics option instructs imsimta
chbuild to output or suppress information on the compiled conversion
tables. This information gives a rough measurement of the efficiency of the
compilation, and may indicate whether or not an additional rebuild with the -option_file option is needed. The -nostatistics option
is the default.

Example

The standard command you use to compile character set conversion tables
is: