Compile the PMDF character set conversion tables and load the resulting image file into shared memory.
Command Qualifiers Defaults
Must have superuser privileges (UNIX) or be logged in as Administrator (NT) in order to use this utility.
pmdf chbuildutility 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.
pmdf chbuildcreates 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_filequalifier, an alternate file name may be specified. When the
-noimage_filequalifier is specified,
pmdf chbuilddoes not produce an output image file. This qualifier is used in conjunction with the
-option_filequalifier to produce as output an option file which specifies table sizes adequate to hold the tables required by the processed input files.
/pmdf/table/maximum_charset.datis 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
-maximumis 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
-option_filequalifiers 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
-maximumto 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 chbuildcan 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_filequalifier 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_filequalifier may be used to specify an alternate file name. If the
-nooption_filequalifier is given, then no option file will be output.
pmdf chbuildalways 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
pmdf chbuildto read options from
maximum_charset.datin 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_filequalifier should always be specified when
-maximumis specified since a maximum-size image would be truly enormous and extremely wasteful.
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).
pmdf chbuildto output information on the sizes of the uncompiled character set tables.
pmdf chbuildto 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_filequalifier is needed.
The standard command used on UNIX to compile character set conversion tables is:
or on NT:
# pmdf chbuild
C:\> pmdf chbuild