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

Parameters

None.

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.

Command Qualifiers

/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.

/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.

/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.

/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 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 commands used to compile character set conversion tables and reinstall them are:

$ PMDF CHBUILD $ INSTALL REPLACE PMDF_CHARSET_DATA