VMS Help  —  LOCALE  COMPILE
   Converts a locale source file into a binary locale file.  The
   binary locale file is used by utilities and C routines that are
   dependent on the setting of the international environment logical
   names.

   Format:

        LOCALE COMPILE sourcefile

1  –  Parameter

   sourcefile

     The file specification of the locale source file.  This file
     defines each category of the locale.  The default file type for
     the source file is .LSRC.

2  –  Qualifiers

2.1    /CHARACTER_DEFINITIONS

     /[NO]CHARACTER_DEFINITIONS[=filename]
     /NOCHARACTER_DEFINITIONS (D)

   Specifies a character-set description file (charmap) for the
   locale.  This file maps characters to their actual character
   encodings.  If a charmap is not specified, no symbolic names
   (other than collating symbols defined in a collating symbol
   keyword) are allowed in the locale source file.  The default file
   type for a charmap is .CMAP.

2.2    /DISPLAY

     /DISPLAY[=[NO]HOLE]
     /DISPLAY=NOHOLE (D)

   Used with certain Chinese locales and terminals to
   specify that 4-byte characters occupy four printing
   positions (columns) on the terminal display. The default
   value (/DISPLAY=NOHOLE) specifies that 4-byte characters
   occupy two printing positions.

2.3    /IGNORE=WARNINGS

     /[NO]IGNORE=WARNINGS
     /NOIGNORE=WARNINGS (D)

   Generates an output file even if LOCALE COMPILE issues warning
   messages.  Use the /IGNORE qualifier with caution because warning
   messages can indicate user errors that you might want to fix
   before using the resulting locale file.

2.4    /LISTING

     /[NO]LISTING[=filename]
     /LISTING[=filename] (Batch Default)
     /NOLISTING (Interactive Default)

   Specifies the name of the listing file.  The /SHOW qualifier
   controls the information included in the listing file.  If the
   filename is omitted, the default is sourcefile.LIS.

2.5    /OUTPUT

     /[NO]OUTPUT[=filename]
     /NOOUTPUT (D)

   Specifies the name of the output file.  If the /OUTPUT qualifier
   is omitted, the default output filename is sourcefile.LOCALE.
   Public locales are stored in the directory defined by the logical
   name SYS$I18N_LOCALE.  If the output file is in any other
   location, the locale is private.

   If /NOOUTPUT is specified, the compiler does not create an output
   file, even if the compilation is successful.

2.6    /SHOW

     /SHOW[=(keyword[,...])])
     /SHOW=(SOURCE,TERMINAL) (D)

   Use /SHOW together with /LIST to control the information included
   in the listing file.  You can specify the following keywords:

   ALL                        Include all information.

   BRIEF                      Include a summary of the symbol table.

   [NO]CHARACTER_DEFINITIONS  Include/omit the charmap file.

   NONE                       Do not print any information.  If NONE
                              is specified, the listing file only
                              contains the error messages generated.

   [NO]SOURCE                 Include/omit a listing of the source
                              file.

   [NO]STATISTICS             Include/omit compiler performance
                              information.

   [NO]SYMBOLS                Include/omit a listing of the charmap
                              symbol table.

   [NO]TERMINAL               Display compiler messages at the
                              terminal.
Close Help