PMDF System Manager's Guide
PMDF-REF-6.0

Compile the PMDF character set conversion tables and load the resulting image file into shared memory.

Syntax

pmdf chbuild

Command Qualifiers	Defaults
-image_file=file-spec	-image_file=PMDF_CHARSET_DATA
-maximum	-nomaximum
-option_file=file-spec	-option_file=PMDF_CHARSET_OPTION_FILE
-remove	None
-sizes	-nosizes
-statistics	-nostatistics

restrictions

Must have superuser privileges (UNIX) or be logged in as Administrator (NT) in order to use this utility.

PARAMETERS

None.

DESCRIPTION

The pmdf chbuild utility compiles the character set conversion tables and loads the resulting image file into shared memory.

PMDF ships with very complete character set tables so it is not normally necessary to run this utility.

COMMAND QUALIFIERS

-image_file[=file-spec]

-noimage_file

By default, pmdf chbuild creates as output the image file named by the PMDF_CHARSET_DATA option of the PMDF tailor file, /etc/pmdf_tailor, (UNIX) or Tailor Registry entry (NT). With the -image_file qualifier, an alternate file name may be specified. When the -noimage_file qualifier is specified, pmdf chbuild does not produce an output image file. This qualifier is used in conjunction with the -option_file qualifier to produce as output an option file which specifies table sizes adequate to hold the tables required by the processed input files.

-maximum

-nomaximum (default)

The file /pmdf/table/maximum_charset.dat is read in addition to the file named by the PMDF_CHARSET_OPTION_FILE option of the PMDF tailor file, /etc/pmdf_tailor, (UNIX) or Tailor Registry entry (NT) when -maximum is specified. This file specifies near maximum table sizes but does not change any other option file parameter settings. Only use this qualifier if the current table sizes are inadequate. The -noimage_file and -option_file qualifiers should always be used in conjunction with this qualifier---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 so that a properly sized character set image can be built with a subsequent pmdf chbuild invocation.

-option_file[=file-spec]

-nooption_file

pmdf chbuild can optionally produce an option file that contains correct table sizes to hold the character set conversion tables which were just compiled (plus a little room for growth). The -option_file qualifier causes this file to be output. By default, this file is the file named by the PMDF_CHARSET_OPTION_FILE option of the PMDF tailor file, /etc/pmdf_tailor, (UNIX) or Tailor Registry entry (NT). The value on the -option_file qualifier may be used to specify an alternate file name. If the -nooption_file qualifier is given, then no option file will be output. pmdf chbuild always reads any option file (i.e., the file named by the PMDF_OPTION_FILE option of the PMDF tailor file or Tailor key in the NT Registry) that is already present; use of this qualifier will not alter this behavior. However, use of the -maximum qualifier causes pmdf chbuild to read options from maximum_charset.dat in addition to PMDF_CHARSET_OPTION_FILE. This file specifies near maximum table sizes. Only use this qualifier if the current table sizes are inadequate, and only use it to create a new option file. The -noimage_file qualifier should always be specified when -maximum is specified since a maximum-size image would be truly enormous and extremely wasteful.

-remove

Remove any existant compiled character set conversion table; i.e., remove the file named by the PMDF_CHARSET_DATA option of the PMDF tailor file, /etc/pmdf_tailor, (UNIX) or Tailor Registry entry (NT).

-sizes

-nosizes (default)

The -sizes qualifier instructs pmdf chbuild to output information on the sizes of the uncompiled character set tables.

-statistics

-nostatistics (default)

The -statistics qualifier instructs pmdf chbuild to output information on the compiled conversion tables. These numbers give a rough measurement of the efficiency of the compilation, and may indicate whether or not an additional rebuild with the -option_file qualifier is needed.

EXAMPLES

The standard command used on UNIX to compile character set conversion tables is:

# pmdf chbuild

or on NT:

C:\> pmdf chbuild