Compile the PMDF character set conversion tables in an OpenVMS
shareable image.
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
/STATISTICS /NOSTATISTICS
1 – Parameters
None.
2 – Description
The CHBUILD utility compiles the character set conversion tables
into an OpenVMS shareable image. The resulting file can then be
installed with the OpenVMS INSTALL utility.
PMDF ships with very complete character set tables so it is not
normally necessary to run this utility.
3 – Command Qualifiers
3.1 /IMAGE_FILE
/IMAGE_FILE=file-spec
/NOIMAGE_FILE
By default, CHBUILD creates as output the file PMDF_CHARSET_DATA.
With the /IMAGE_FILE qualifier, an alternate file name may be
specified.
When the /NOIMAGE_FILE qualifier is specified, CHBUILD does not
produce an output 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.
3.2 /MAXIMUM
/MAXIMUM
/NOMAXIMUM (default)
The file PMDF_TABLE:MAXIMUM_CHARSET.DAT is read in addition to
the file PMDF_CHARSET_OPTION_FILE 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 and
/OPTION_FILE qualifiers should always be used in conjunction with
this qualifier-it makes no sense to output the enormous character
set image 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 character set option file so that a properly
sized character set data can be built with a subsequent CHBUILD
invocation.
3.3 /OPTION_FILE
/OPTION_FILE[=file-spec]
/NOOPTION_FILE (default)
CHBUILD can optionally produce an option file that contains
correct table sizes to hold the 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 pointed to by the logical PMDF_CHARSET_OPTION_FILE,
normally PMDF_TABLE:OPTION_CHARSET.DAT. 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.
CHBUILD always reads any option file that is already present via
the PMDF_CHARSET_OPTION_FILE logical name; use of this qualifier
will not alter this behavior. However, use of the /MAXIMUM
qualifier causes 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 qualifier should always be specified when
/MAXIMUM is specified since a maximum-size image would be truly
enormous and extremely wasteful.
3.4 /SIZES
/SIZES
/NOSIZES (default)
The /SIZES qualifier instructs PMDF CHBUILD to output information
on the sizes of the uncompiled character set tables.
3.5 /STATISTICS
/STATISTICS
/NOSTATISTICS (default)
The /STATISTICS qualifier instructs 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.
4 – Examples
The standard commands used to compile character set conversion
tables and reinstall them are:
$ PMDF CHBUILD
$ INSTALL REPLACE PMDF_CHARSET_DATA