Library /sys$common/syshlp/helplib.hlb  —  PMDF  CHBUILD
    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
Close Help